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1.0 PREF OVERVIEW 


The Parformance Reporting Facility (PRF) is an integrated 
parformancs raporting package for NOS/VE. Some portions of PREF 
run on NOS/VE in 180 state while the rest of the package 
currently runs in 170 state under NOS/170. PRE is intended to be 
a modular system which cen be extended into a Full short and long 
term performance tracking system. | 


The currant PREF is based on the PMF hardware option for CYSER 


L293. jIn the longer terms it wlll acceot performance data from 
ether sources and maintain a parPormance database. 


Contro! Data Private 


Performance Reporting Fecility ERS 


PRE OVERVIEW 


lel 2ME_HARDWARE 


The Performance Monitoring Facility (PMF) Is a CYBER 180 hardware 
go9tion which provides a set of hardware counters and event 
buffers designed to coliect performance data about the system. 
Significant hardware states and/or avents may be timed and 
counted through PMF counters. Oata on software events within 
NOS7VE and Its product set may be obtained by inserting keypoint 
instructions in the software which may be collected through the 
PMF keyoolnt buffers. Recause PMF uses a combination of hardware 
and software monitoring techniquass it is @ good example of an 
integrated hybrid performance monitor, 


PME hardware contains eight 32-bit counters which may count 
hardware events and time system states. The list of eavents and 
states supported is model dependent and there is a sefecticon code 
associated with each one. A timited amount of signal combinetion 
Is allowed through A/B counter palrings and appropriate control 
codese Event/state selection and signal combination are 
controlled through settings in register 22. 


lelelel EvantZitete List 


To be supolied. 


Lele? KEYPDINT INSTRUCTIONS 


Keyooints are speciel 180 instructions which place an Indication 
of sianificant software evants into the FIFO buffer in PMF 
hardware or cause a keypoint trap to allow the data to be 
collected by software. These instructions act as NO-OPs to the 
NOS/7Ve software unless keypoint traps are enabled. In any system 
with the OMF hardware options hardware collection rather than 
software collection should be usad as there is aimost no system 
averhead Involved in gathering the parformance datas 


By conventions kaypoltlnts are used to mark the entry and exit 
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1.1.2 KEYPOINT INSTRUCTIONS 


points of major O/S$ and product sat routiness to Fiag unusual 
events of high importances and to indicate significant events for 
debugging. This mechanism provides a very tow overhead system 
tracing mechanism as wall as a performance tracking facility. 


Lele3d PHF KEYPDINT BUFFER 


PMF has a circular eavent buffar used to hold keyooint data for 
collection atong with an associated time stamp. The exact size 
of this buffer is model-desendent as shown below? 


825 15 keypoints 
B35 15 keypolints 
B55 15 kevypoints 
Theta 1024 keypoints 
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1.2 PMF DATA COLLECTION 


1.2 BME DATA_COLLECTION 


PME sounter and keypoint data may be collected by the CPKPNEDS 
program on NOS/170. CPKPNOS operates in one of two wodes 
depandina on whether keypoint collection is selected or note If 
keyooint collection Is not salacteds, CPKPNOS calls up e P 
program (PMF) to initialize counter collection through register 
22 and then the PP program drops oute CPKPNOS must then be 
called up again when the counters are to bea read out. If 
keyooint sollestion is selacteds tha PP program will remain 
resident to continuously collect the contents of the keypoint 
buffer as it is being filled. 
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1.3 PMF DATA REDUCTION 


ra 


13 BY 


-DATA REDUCTION 


There are currently two components of PHF data reductions the 
Primary Data Peduction Package and the Call Analysis Syster. The 
Primary Dats Reduction Peckage Is designed to give overview 
information about system behaviour during the keypoint collection 
and the Gall Analysis System glyes microlevel timing information 
on tha operation of procedures within NOS/VE and its product seat. 
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200 KEY2OLNT 


~CONVENTIONS AND _ GUIDELINES 


The CYS°R 185 System Interface Standard {($I5) describes 
canventions for the placement of keypolints within the 0/5 and 
oroduct set members. Further documentation is found In the 
jatest NOS /VE Heloful Hints document. 
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2.0 KEYPOINT CONVENTIONS ANO GUIDELINES 
201 KEYPOINT CLASSES 


ILNI_CLASSES 


2el KEY2! 


The 180 hardware allows 16 keypoint classes and collection of 
kayooints is controlted by a kaypoint mask in the task's exchange 
package. Only those keypoints whose class matches one of the 
classes set in the keyopoint mask will be collected by elther 
hardware or software collestion. This aliows the kaypoint 
classes to define a collection hierarchy. The following table 
shows the keypoint class assignments. 


aiass Sed Ott cee wee ewawet uae 


S/S data 

5735 unusual events 

Q/S procedure entry 

9/78 procedure exit 

75 debug 

N/35 PAS (Performance Analysis Sevicaeas) 
Product set data 

Product set unusual events 
Product set erecedure antry 
Product set procedure exit 
Preduct seat debug 

Reserved for end users 

PMF hardware start/stoo control! 


iH 2 ) 4) Go ag Ge UI 4 lo TB 


bod 

oan 

j 
hp be 
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202 KEYPOINT IDENTIFIERS AND DATA FIELDS 


2e2 KEYPQINT_IDENTIETESS AND DATA _ELELDS 


Each keypoint instruction executed which provides data for 
hardware or software keypoint sollection leaves a 32—bit data 
eortion in the event in the collection buffer. By conventions 
this is divided Into two sections» a LlZ-bit keypoint identifier 
and a 25-bit data field. The keypoint identifier is used in 
conjunction with the keypoint class to determine the actual event 
whieh triagered the keypoint Instruction. The date field may be 
used to provide any information of interest associated with the 
keyooint event (eege the PTL ordinal of a task being disoatched). 
TF twenty bits are not sufficient for the dasired informatians 
the DATA class allows this to be extended by up to thirty-two 
more bits to give a total of fifty-two bits of data. The DATA 
class should be used with caution as it may cause keysolint 
clustering resulting in an ovarfiow of the 16 avant FIFO buffer 
in PMF hardware. Also note that DATA class «eypoints are net 
allowed in conjunction with UNUSUAL class keypoints.e 
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2.3 CYBLL_KEYPOINT INIZINSIC 


CY3IL provides an Intrinsic to qenerate keypoint Instructions 
diractiy Prom CYRIL code. This Intrinsic is usad In canjunction 
with standard kaypoint common dack declarations to generate the 
actual keypoint instructions present in NOS/VE and product set 
code. The form of the Intrinsic is as follows! 


AKEYPOINT( keypoint class» oskSm * datas keypoint id) 3 
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th 


(204 KEYROINT COMMON DECK STEUCTURE 


There are a standard set of common decks provided for use by G75 
and oroduct set developers in Instrumenting their code. In 
additions there are standard rules for addina keypoint 
description common decks for other areas which are teing 
keypointed. The currently defined common decks are found En 
MOSVEPL and OSLPI for NOS/VE and In OSLPI and PSCOMPL for the 
eroduct seat. 


2e4e]1 KEYPOINT CLASS COMMON DECKS 


Thera are three main common decks used to define the classes for 
a NOS/VE system» OSDKEYS In NASVEPLs, OS5DKEYC In DOSLPI» and 
PSDKEYC In PSCOMPL. OSOKEYS contains the mastar range 
declaration and <QS5SDKEYC and PSOKEYO contain the actual class 
declarations for the O/S and eroducst set respectively. 


Listings of these three common dacks follow: 
OSDKEYS 
CONST 


{ Keypooint Classes 3 

{ 

{ The 16 keypoint classes supported by the hardware are partitioned 
{ hatween the Systems Product Set and User as follows. 


osk$system class = 0 {[ OQ ef 3 Fs 
oskieroduct _set_class = 6 € 6 «2 10 Fy» 
osktuser_class = 11 { 11 ee 14 Fy» 
oskSomf control = 153 


Kaypoint Multioliers 


By conventions the 32 bit keypoint code supported by the hardwere 
is split into two Fields.e The right fileitd contains a keypoint 
identifier which Is used to identify a function within @ kaypoint class. 
For exampies if a particular keyooint class represents exit from a 
procedures, then the keypolnt identifier might identify exit from 
orocedure A versus axit fron orocedure 3. 

The laft field is used as a data parameter appropriate toa the 
function identified by the keypoint identifier, In the procedure exit 
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2039 KEYPOINT CONVENTIONS AND GUIDELINES 
Ze4el KEYPQINT CLASS COMMON DECKS 


status of the procedure call. 


identifier field. 


CONST 
osk$m = 40943 


examole aboves the data parameter fileid might be used to ind 


ate the 


The keypoint multiplier Is used to partition the keypoint sede 
into the two fields. Tha data parameter should be multiplied by the 
kaypoint multiplier to prevent it from overlapping the keypoint 


daQ¢eyve 


(Define KEYPDINT CLASS Codes. 


CONST 


osk$data = osk$system_class + Gs { 35 - DATA keypoint} 
osk¢unusual = osk$system class + I» {U0 OS - Unusual keyooint class.} 


osktantry = oskSsystem_ class + 29 {5 O38 = Standard keypoint (gatec cor major 


osktexit = osk$system_class + 3» {X O8 - cxit keypolint?} 
osk$dadug = osk$systen_ class + 45 €)0 OS - Dabug keyooint.} 
osktreserved = osktsystem class + 53 {R 05 - Reserved keypoint.} 


PZDKEYE 


To be suppiied. 


Ze%e2 KEYPQINT IDENTIFIER COMMON GECKS 


There are two common decks which declare the Identifler ranges 


for the 


2/5 and product sets. These are OSDOKEYD in OSLPY end 


PSDKEYD in PSSOMPL For the O78 and product sets respectively. 


Thera 
they be 
product 


@ required convention for al] range definitions that 


of the form XXktbase for the O/7S and YY¥k$psbase For the 


set where XX and YY area the two character area 


desianators for the O/3 and product set respectively. 


Listings of these common decks fallow: 
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OSD<2Y0 
{This deck defines constants for use with KEYPOINTS, 
(Define base keypoint procedure identifiers for each area of the 05. 


CONST 
amkthase 
hakSihase 
clktbase 
emk Shasa 
dbkt base 
dmkthbase 
Fakthase 
ickt base 
ifktbase 
bikibase 
Ink$base 
dmk$ bas a 
Igkt base 
}iktbase 


{it - 149} 

{156 ~- 249} 

{230 - 299} 

{2906 - 349} 

{330 - 399} 

{400 = 549} 

{5560 - 599} 

{506 - 649} 

{4560 =~ 699} 

{700 = 749} 

{750 - 799} 

{800 —- 849} 

{856 - 899} 

{900 - 949) 
lokShase 950 - 999} 
fukSoase 1000» {1000 - 1049} 
mikSbase = 1050» {1050 - 1099} 
mmakémonitor base = 1100s {1100 - 1149} 
mamkS Job_base = 1159» (£1150 - 1199} 
msk$Rbase = 12005 {1200 - 1249} 
mtktbase 1250.5 {1250 - 1299} 
ockbbase 13005 €1300 = 1349} 
ofkibase 1350» €1350 - 1399} 
osktbase 1400» £1400 —- 1449} 
pfkt base 15005 {1500 - 1549} 
pmk$base 1500» £1600 — 1699} 
rhktbase 1730» €1750 - 1799} 
srk¢thase = 1800» {1800 — 1319} 
stk$base = 1850» {185060 - 1899} 
tmktmonitor base = 19005 £1900 - 1949} 
tmk$ Job base = 19305 {£1950 - 1999} 
isk$monitor base = 2000s {2000 - 2049} 
isk$job base = 2050» {2056 - 29599} 
avk$base = 210% {2100 - 2149} 
sfkthase 2150» {2150 2199} 
loktbase 2200» {2200 2249} 
rmaktbase 22509 {2250 = 2299} 
dmk$taoe_base = 2300» {2300 - 2349} 
syk% job_base = 2350» £2350 - 2399} 
mtkZassembiy_ language base = 40003 £4000 = 4095} 

{ 95 assembly language 4900 ~ 4095} 


nt wu 8 wow ot tt © uw # ah non 


tou # tt wu tt 
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(2e0 KEYPOINT CONVENTIONS AND GUIDELINES 
20402 KEYPOQINT IDENTIFIER COMMON DECKS 


To be supplied. 


20403 KEYPOINT 


QEFINITION COMMON DECKS 


each area identified In OSOKEYD and PSDKEYD shoutd have a 
keypoint definition common deck to give the exact keyoolint codes 
and data Pormat as well as special flags for the data reduction 
software. Fach area has a two character string which identifies 
it. For the product sat» this is the two character product 
Identifier as described in the SIS. The standard convention for 
aaning J/5 keypoint definition common dacks is xxDKEY where xx Is 
the two character area name. The convention for those for the 
product seat is xwxDKe YP in a similar veins 


The following O/7S and product sat common deck listings show how 
these entries are set upe 


£ PURPOSEs 
f This deck contains all of the set manager keavyooint constants. 


CONST 
TENTRY/EXIT CLASS KEYPDINTS +} 
{gated entry points for users} 


stktcreate_set = stkthase + 1» 
{2 Istossreate_set' fring ' 4 } 
{X 'stptcreate_set' ‘status ' [20 } 


stk$purge_set = stk$base + 2» 
CE 'stotpurgecset? } 
‘YX ‘'stotpurge set! 'status ' [20 } 


stktadd_ member _vol_to_set = stkthase + 3» 
{2 'stptadd member _vol_to_set' } 
€X ‘'Istos$add_ member vol _to_set! 'status ' [20 } 


stktremove_member_vol_from_ sat = stktbase + 4» 
{EE ‘'stotremove member vol from set! } 
{YX 'Istpot¢remove_nember_vol_from sat! 'status ' I20 } 


stkichange_accass_to_set = stkSbase + 5,5 
z ‘'stpSchangelaccess_to_set!' ‘access ' H29 } 
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UE A 2D EE RAN NR A: NE NR A PE AND ND i SP NG AE AR NRE A NS SA SA OE NE SE A: I A A SE TR ee EE ED AED A TE A A A EN A ie ER A A 2 ee es 


{X ‘'Istotchange_access to_set? 'status ' T2C } 


{interfaces into sets from other Functional areas } 
{calls from device management } 


stktgqet Jobs sorateh volumas = stk$base + 10s 
{2 ‘'Istp$get_ jobs scratch volumes! } 
{X ‘'stosget Jobs uscratch_ volumes’ 'status ' [20 } 


stktoet_volumes_iInuset = stktbase + lls 
{= ‘'Istosgetivolumes _inusat’ 'setinit ' H20 } 
€X¥ Istotget_volumes_in set! ‘status ' 120 } 


stkigetlvolumes_by set_ordinal = stk$base + i2» 
{=e 'stypsget_volumes_by_sat_lordinai’ } 
{X 'Istotget volumes _ by_set_ordinal' "status ' 1295 } 


stkiget_volumaes set name = stkSbase + 13,» 
f= ‘'‘stotget_volumes_set_namet 'vsn ' AZZ } 
{% tstptget_volumes_set_name! 'status ' 120 } 


stkSis volume lin set = stkthase + 14» 
f£ 'stotis _volume_in set! } 
{X% tstpsis_volume_In_set! "status ' 420 } 


stktdisk volume_lactive = stkS$base + 15,» 
{© 'stotdisk volume_activea’t tavtindx * 420 } 
TX ‘'stotdisk_volume_active’t 'status !' [20 } 


stkidisk volume_inactive = stk$base + 16» 
{= tstp$disk uvolume_inactive’ 'satord ' H20 
{X% 'Istotdisk uvolume_iInactive'’' "status ' 120 


taps ays 


fealis from permanent files } 


stktget_of_root_size = stk$base + 20» 
{£ ‘'stpetget_pf_root.size' } 
{X¥ 'stosgget_pflroot_size’ 'status ' I26 } 


stktgoet pf root = stkS$base + 21>» 

{CE 'stotget_of_root! } 

{X 'stosget _pf_root' 'status ' 129 } 
stktstore_pf_root = stkSbase + 22s 

{EF ‘'sto¢store pf root! } 

{X ‘'stp$storea_lpf_root' 'status ' 129 } 


stktourge_pf_root = stkShbase + 23>» 
{& ‘'stpSpurge_pflroot! } 
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(Xx ‘'stoSpur ge_ef_root? *status 


stktiqet setlowner = stktbhase + 24s 
fe 'stptgetiset owner? } 
{X ‘'fsto$get_set owner’ 'status 


stk$setlof_lock = stk$base + 25>» 
fE 'stptsat_pfilock! } 
{X 'tstp$set_pf_ lock! 'status ! 


stk$cleer_pfllock = stk$base + 25» 
fe «6'stos$ciear pfilock! } 

{X ‘'stpt$clear_pf_lock! ‘status 
{call from jod manaegenent} 
stk$setlend job = stk$base + 27>» 

{= ‘%Isto$set_end_ job! } 

{X 'stptset_and. job! 'status ! 


{call during deadstart sequence } 


[20 } 


ee 658 


T20 } 


stktinitialize sets = stk$base + 29% 


f& ‘'styosinitialize sets } 


{X% ‘'stptinitialize sets! 'status 


' 120 


stk3get_aective_set_fist = stktbase + 30>» 
{fe 'stotget_active.-satllist’ "setlis 
T¥ ‘'stp$get_active set liist! 'numset 


{UNUSUAL CLASS keypoints } 


stkicant udm store _set_ord = stk$basey» 


{ teant dmptstore_avt uset_lordinai! 


CMERUG keaypoints } : 


stktset_exclusive lock = stktbase,» 
{2 ‘'set exclusive access! } 


stkiclear_exciusive lock = stk$base + i» 


{9 ‘elear exctusive access! } 


stk$ast_index assigned = stktbasa + 25 
{0 ‘active set table index assigned! 


stk$nexH#_job_accessing_set = stkthase + 3» 
(0 "first of access of sets within job! 


f‘aytindx 


H20 } 


H20 } 
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stktimel_index_assigned = stkthbase + 4» 
{D> ‘'mel index assianed ~- ast Index V' "status ' T2060 } 


stk$pf root size = stk$base + 533 
{9 '‘pflroot size’ 'rootsiz ' H20 } 


7? PUSH (LIST t= OFF) 22 
EMOKEYS 


To be supplied. 
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22> BNE KEYPOINT ESE ATES OR 
2e5 QNE_KEYPOINI_DESCRIPTION 
<analyzer deseriptor_input>d it= <keypoint uclass_ allocation deck> 


{ <definition deck> wer. 


<keaypoint_class_allocatlion _deck> tt= <cybil code and/or comments> 
[ <class base _definitions> +. 3 
<eybil code and/or comments> 


<class _base_definitions> t2= <class -base_id> <spc> = <seed> <based 


<class _base_id> %32= osktsystem class } eskSproduct set uclass i 
oskfuser class ! osktpmf_control 


X<spe> t:3= <spaced € <space> ees | {one or more) 
<hbasad 332 <Integerd 


<definition deck> t3= <class _dafinition deck> | 
<base_definition_deck> } 
<keyooint definition deck> 


<class definition _deck> tt= £€£$$4 START KEYPOINT CLASSES $$} 
<cybil code and/or comments> 
€elass dafinitions> »... J] 
<cybil code and/or comments> 
{$$$ END KEYPOINT CLASS=S 3%} 


<class_definitions> %2= <keyooint_class> <spe> = <soe> 
Cclass_base_id> <offset> 
{ <kaypoint iclass_id> <cybifl comment> 
<keypoint_class> 282 <identifler> 
<offset> :3= + “sped <integer> <datimiter>d 
<delimiter> t:= » 3 
<kaypoint class_id> *%t2= <character> 
Cbase_definition_deck> %%= 
{$$% START KEYPOINT IDENTIFIER BASES $44} 
<eybil code and/or comments> 
{ <range_base_definitions> ees. 7 
<eydbil code and/or comments> 
{$8 END KEYPOINT TOENTIFIER BASES $453 
<range_base_definitions> t2= <keypoint base> <delimiter> 
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ZG KEYPOINT CONVENTIONS AND GUIDELINES 
265 BNF KEYOOINT DESCRIPTION 


<base ranged 

<kaypoint_base> 23= <sped <hase_id> <spc> = <spe> <base> 
<hasea_id> 222 <jdentifier> 
<hase .range> t= <spe> { <iow_base@> <sp> - <highbase> €— } 
<low_basea> *12= <integer>d 
<high base> t2= <integer> 
<keypoint definition. deck> tts 

{$$$ START KEYPOINT OcSCRIPTIONS $34} 

<ceybil code and/or comments> 

{C <xxdkey_ deck> ees. |] 

<cybil code and or camments> 

£$$$ END KEYPOINT DESCRIPTIONS $443 


Cxxdkey deck> 33= (€ <cybl!l code and/or comments> Jj 
{ <keypoint_infa> ase 


<keyooint_infoa>d 232 <keypoint_constant_tine> <delimiter> <eo0l> 
{ <keypoint descriptor> ess } 
{ <blank lines> 1 


<keaypoint constant_line> 2% <keypoint_constant> <spe> = <sped> 
<keypoint _base> <spe> [— <offset> ] <spe>d 


<keypoint_constant> tr= <identifier>d 
<keaypoint base> 232 <identifier>d 


<keaypoint descriptor> 23= { <keypolint_descriptor_list> 
[ <soe> ] € } J <eold 
<keypoint _descriptor_list> t= <keypoint class _id> 
{ <special_case_code> ] 
{ <spe> <subLid fietd> J] 
€spc> <kevypoint  labe i> 
{[ <spoe> <data field> J 


<soacial_cese_cade> ?3= M3 Ni $ i T 
(M = Mtr» N = Noss 3 = task Switch» and T = Trap) 


CsubLid _fieid> t2= <sublLid_ienath> «© <subLidumatch> 


<sud_id_length> t3= <field length> 
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2.5 BNF KEYPOINT DESCRIPTION 


<field langth> 2: = 6.252 | (in bits) 
<sub_id_match> 3:25 <small_linteger> 

€smali_itInteaer> t3= O620 FFFFFFFEFFFEFF(16) 

<keypoint tabel> t:= <fabel> 

<label> 332+ ' <characterwstring> ! 

<character_ustring> 32322 € <alphabet> ee. 7 ; | {zero or more) 
<data_field> is= <data_label> {C <spco> <data_fieldidescriptor> ] 
<data_!abel> t= <label>d 

<data_fleaidldescriptor> it <data_format> { <data field ilength> ] 


<datea_format> st= A} HY I 
(4 = Alphanumeritcs H = Hexs I = Integer) 


<data _fleidliength> t:= <field llength> 
NOTE? <<sublid ltength> + <data _fleld_vlength> must be <= 52 bits } 
Jeerating systen <kaypoint class _id> = {D»sE»sUsX}) 


<keypoint class _i@ for any keypoint used for additional 
Information to orevious keyootnts must be 2a space) 


A <definitlon dack> remains In effect until superceeded by 
a deck which redefines the area to which it partains) 
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3e0 NOS/VE KE YPDINT COMMANDS 


3.0 NOSZVE _KIYPOINT COMMANDS 


There are three NOS/VE commands supplied to contro! kevpoint 
processing and to issue svoecific keyooints at a command level. 
Thes2 commands are also defined in the Helpful Hints decument for 
the current cycie of NOS/VE,. 
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3.1 CONTROL COMMANDS 


301 CONTEQL_COMMANDS © 


These two commands control the setting of the keyeoint masks in 
the job and monitor mode exchange packages and the type of 
kayooint collection. 


Belei ACTIVATE KEYPOINT 


The activate_keaypoint command (abbreviated actk) initiates 
keyooint recording and collection. This is done directly for 
software keypoint collection but hardware collection alse 
requires the 170 stete keypolint collaction program CPKPNOS to be 
Initiated. 


The parameters for the actk command are as Follows: 


Kevd ORD DESERLTPTLON VALUE QEEAULT 


moda collection softwareisihardwareth parameter 
in mode required 


anvironaent recording dobi jisystem!s oarameter 
2 esnvironmant reaulred 


monitor omask fist of {4s19.0915) (0..15) 
mm intagers 


Job _mas« list of {Oel59-2915) (6.215) 
in Integers 


start lcilass integer Os liee 315 13 
start 


ston _stlass integer Oyit..315 Ls 
stop 


keypoint_ tite name of file File name $LOCAL. 
« for software KEYFILE 
collection 


collector buffer integer 19092 elQ5GGu9 LOGEC 


size 
cos 


Control Data Private 


3-3 


v 


Performance Reeorting Facility ERS 
2% Feb BS 
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Zelel ACTIVATELKEYPOINT 


collector delay delay period 1022100000 20 
ed in milliseconds 


Bels2 DEACTIVATE_KEYPOINT 


The deactivate _keypoint command (abbreviated deak) is used to 
terminate the issulng of keypolnts by clearing the keypoint masks 
in the job and monitor mode exchange packages ans ending software 
collection (if enabled). 


KeywoRD DESCRIPTION VALUE DEEAULI 


environment . recording Jobijisystemis job 
e environment 
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30.9 NOS/VE KEYPOINT COMMANDS 
3e2 KEYPOINT ISSUE COMMANDS 


302 KEYPOINT_ISSUE_ COMMANOS 

3201 EMIT_KEYPOINT 

The emit _keypoint command (abbreviated emik) is used to Issue a 
keypoint at the SCL tevel. Its main use is to issue class 15 


kaypoints to start and ston keypolint collection runs. 


KEYWORD QEStRLTPTLON VALUE REEAULT 


wee 
pus 
pa 
‘Fi 


class kKeypoint class Cilies3: 


code kavpoint code OL. ef PRFEFFFEF (16) f 


« 
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4,5 PMF SOFTWARE OVERVIEW 


400 24 S2ETHARE_OVERYLEW 


The 850 serles machines have a performance monitoring facility 
{PMF) bullt into the hardwara. Various typas of data are made 
available for monitoring system performance, This Introduction 
will not deal with the details of what is available or the 
detalis of how to collect the data. 


The coallection is initiated from the system consote for systems 
which, at this times are running in dual state. Keypolint 
Instructions have been inserted at the geted entries and exits of 
significant procedures In the operating system (08) and product 
set €?5). There may also be other kaypoints inserted for date 
collection or other purposes. In additions some processor state 
data is availeble., This user guide is directed towards the users 
of the kevpoint data. 


The keyopoint data must be analyzed to obtain useful Information. 
The set of programs in this user guide js directed toward 
describing the tools avaliable to analysts for transforming data 
into informations 


The Kaypoint collection is done fron the operator consoie white 
NOSVE is running the job(s) to be analyzed. The output is the 
raw kKeypolnts data File (KPTS). This Is run each time a jobs) 
Is to be analyzed, 


The following is an exampie of the logical sequence and 
intercation of programs and data! 


Date Collaction --=-> raw-data 
KPPRE -—=-> preorocss~data 

}—-=-> KPRED --=—> rapvortis) 
KPPAR m—m=—=> KPPRE —=] 

f$=—> KPTRUIN -——> raport 
raw-data m= 

j<——-> KPORY <---> auarles 

preprocss~-data --} 


rawwdata ~—-> KPCNT -—=-> report 


The overall process is shown In figure l. 
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4.0 PMF SOFTWARE OVERVIEW 


KP PAR Is run to produce the PARSE Pile. This process modifies 
the keypoint data on the common decks Into a form suitable for 
the oreprocessor (KPPRE). This prosess is rerun only if the 
common decks are changed. The outputs PARSFL may be used by all 
of the PME userse 


XPPRE transforms the raw data into a common format for the 
Subsequant analysis programs. It can do some editing of the flie- 
using tne directives from the KLUG file. It can atso select 
portiens of the raw data fiie using the start (STR) end stop 
(STP) directives in the parameter input. The output from the 
preprocessor are tha preprocessed keypoint files the descriptor 
file and several reports. 


KPQRY allows scanning of either the raw keypoints data file or 
the oreprocessad data file to determine some of the data in the 
keypoint filles, This is Intended to make aquicks ad hoc iIngquliries 
about the neture of the kaypointse 


KPRED uses the data from the descriptor File and the preprocessed 
keypoints te make more extensives but oredefineds reports of the 
sontents of the kaypoint runs. 


KPTRUN Is a process (Fig. 23 for analyzing the antries and exits 
from gated keypoints.e It reconstructs the stack to determine the 
execution times within each gated keypoint. It is composed of 2 
CYBIL programs and 2 sorts. CALLAN reads the preprocessed 
Kayooint file and buijds the network of caller-callee 
relationships that exist on the keypoint file. To «eee the 
mamory reguirements lows and to decreasa the processing times the 
networks are are dumped perjodicaliy (every 3000 keypoints) to an 
intermediate file. The sort program simply bunches all the tike 
kaypoints fron the Interval dumps togather for input to the 
COMBINE orogram. The COMBINE program sums the data from e111 the 
kaypoints with the same parent and/or child into one recorde It 
outputs these records together with the keypoint descriptions on 
a file in ascii format on the file specified by the FIRST 
paraneter. Each record contains a parant and usually a child In 
ascil format. The processing to this point needs onty to be done 
onca for any given keypoint file. If reports are desired in 
several different sort orderss the NEWSORT parameter aliows the 
processing to start at this polnt for the second and subsequent 
reports. The Intermediate file is now sorted using the SORTKE 
parameters specified to order the records for the desired report. 
Finally» the PRINT process reads this ordered file and splits the 
combined caller-callee records into records suitable for 
printinge 
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5.0 PME SOFTWARE INSTALLATION 
520 PME_S QEIWARE sw A NZ TALLATION 
MATERIALS PMFPL 

PHECOR 
XULIB - 


Add any local mods to PMFCORs the file containing changes to the 
PMF orogramse 


Add the following statements to the PROFILE file. 
\ PLI8= 'PMFPLIB! 
\ TOOLLI@="XULIB! 
\ TOOLACT= the PMF user namesies»s 'KEYPERF! 


\ SEARCH = (PMFPLIBsthe PMF user name) 


After PHEPL» PMFCOR and XULI8 have been loaded do 

SES.6E NCOMP PMFINST C=PMFCOR 3=PMFPL 

SES2REPPROC G=COMPILE B=PMFPLI3 

SES .PMFINET ALL 
The calls to GEeNCOMP and REPPROC naed only be dona when the PMF 
programs are being Installed for the first time. From then ons 


only PMFINST needs to ba calfed to install the particular modules 
ahich are to be altered. 
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5eQ PME SOFTWARE INSTALLATION 


5e1 2MELNSI 


This procedure installs the various components of the PMF system. 
Tt installs the object code on a tlibrary file» and the SES 
procedures on a PLIB file. Prior to Installation a Files PMFPL», 
containing the various modulas must exist in the instaliation 
user number (UN), A second file» PMFCORs containing the 
correction set must also be avallable.e. The PROFILE of the user 
must contain the dafinitions given above. 


Any of the parameters defined in the SES module JOBPARM may be 
usede These Include JOB8TLs JOBFLs JOBCN,s JOBPR» JOBUN,s JOBPU, 
JOBFALY» JOBCN»s JOBPNs LOCAL» BATCHN»s BATCHs DEFER» NODAYF » 
OAYFILEs AND DOF. (See SES Procedure Writer's Guides Appendix A) 


iInstaltation Parameters? 


CALLAN Install the object for the call analysis oortion of 
KPTRUN. 


COMBINE Install the object code for thea program which combines 
the Intermediate segmants producad by CALLAN (Part of 
KPTRUN). 


PRINT Instali the object code for the routine which orints the 
REPORT(s) (Part of KPTRUN) 


SPKPNODS Installs the CPU portion of the data coliection 
roautinese 


PPKPNOS Instalis the PP portion of the data collection routines, 
KP PRE Install the object code for the Preprocessore 


KP PAR Install the object code for the kaypoint descriptions 
parser program. 


KPRED Instali the object code for the primary data reduction 
proorame 


KPQRY Instail the object code for the KPORY program. 
KPCNT Instali the object code for the KPCNT program, 
All of the above programs are stored on the file XULIB. 


PROMF Install the SES proc for running the keypoint 
collection. 
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300 PMF SOFTWARE INSTALLATION 


PRKPPRE Install the &§ 


PRKPPAR Install the $5: 


PRKPRED Install the 


5 

$ 
PRKPARY Install the SES 
$ 


PRKPCNT Install the $3.55 


KP TRUN Install the 

DProgr anse 

PMFINST SES 
will 


Install 
programs 


tne 
This 


a proc for running 
proc for 
. proc for 
proc for 


proc for 


proc 
usually 


KPPREe 


running KPPAR, 


running KPRED. 


running KPQRY. 


running KPCNT. 


for running the call enalysis 


installation 
when the 


for installing the 


be done only 


installation program has hean modified in PMFCOR, 


ALL Calls for 


orocedurese 


The above erocedures are 
PMFOLTA, 


PLC 


if it is 


ID This earameter 


resides» 
After  PMFINST has completed 
found in KULI3»s and ali outputs 
collection ovrogram is under 
commands nacessary to place the 
SES .GETMEM PMF PP B=XUILIB 


SYSEDI Ts B=GROUP, 


installation of al! 


installed 


is used to specify the account where 
if different than LIBRARY. 


of the above srograms and 


on the SES oroc fibrarys 


This parameter Is used to change the name of system CPL, 
under a differant name. 


PLC 


batch executions all binaries are 
are found in LIST. The PP data 
the name PMF, The sequence of 
code In the system is: 


These commands must be entered from the system console, 
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5.2 PROGRAM MAINTENANCE 


All PMF related material is stored on PMFPL, In order to 
maintain an orderiy system of changing or correcting the programs 
and procedures» ali changes are entered into a correction file. 
This file has two areas for entering changes» General changes 
ara antered In tha correction ID called PMFCOR, It is recognized 
that some sites will have special need to cater to their 
equipment or operaticnal procedures. Accordingty there is a 
correction ID for site focal modifications to be stored. If 
these changes are of general uses then they may be moved into the 
PMFCOR [04 Presentiy» the site local changes reflect the use of 
group encoding used on tape equipment rather than phase encoding. 
In additions it may tbe desirable for some sites to change the 
default conditions on some of the procs and these may also go 
into the site local modse 


There area two methods of generating the corrections. Ona is to 
get the module from PMFPL applying the PMFCOR changess and then 
changing the resultant modula to fix the bug or introduce the 
changee Then after testings maka an SES GENCOR run to produce 
the changas raguiread to go into PMFEGR. The other way is to make 
a GENCOMP run with the S£0 parameter to get the tine numterss 
then enter the proper insert and delete entries In PMFCOR. 
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6.0 PNF DATA COLLECTION (PPKPNDSs CPKPNDS) 


5.0 PME _DATA_ COLLECTION. (PPKPNDS2 _CPKPNOS) 


Thea PHF data collection program was written to provide #8 maans 
for tha sollection of data From the CYBER 180 Performance 
Monitoring Facility (PMF). The program uses the PMF hardware to 
collect Information on program execution and to collect various 
machine statistics. 


Full use of the PMF hardware is possibie with the orogram. In 
additions the program provides keypoint selection options and the 
gapability for the periodic sampling of keypoints. 


The PMF data collection program is written in PP COMPASS and runs 
under the A1L7O NOS operating system. The program will function 
on eithar a strictiy AL7C mode machine or on the 1760 side of 2a 
dual state machine. while running on the 170 side of a dual 
state machines the program can collect information about both the 
AL70 and the 180 sides (through both the counter and keypoint 
mechanisms for 169 state). A179 state collection is timited to 
counter data. 


This document assumes that the reader is familiar with the CYR8ER 
189 Performance Monitoring Facility and CYBER 17G COMPASS. 
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bel PROGRAM CONTROL AND COMMUNICATION 


el 2RQGRAM CONTROL. AND COMMUNICATION 


The program uses several areas in central memory as communication 
areas. These areas are shown in figure 1. 


RA+1 > PMP: LADDER 3 Register 22 3lack 


fe pe ef ee ee | 
; pe oe eee eee he ne} a een ae fee ne ce 
H t<r—>§ 0: 174 24 3 3 4 3 
$e eee > fe fee fee} eee fe ee} 
; ; + +13 3: 64 7 7 8f 9 F 
| cote teateatenbenh deatentennent 2 } pe cen oe fe ce ee he ep ae ef eh 
ADDR H iRGZ2Zjmnmrnmt #27203 112 5 «12 35 «13 3 «14 3 
| ceeneadunbasiententaats, Sonmentemmonte 2 fe he ef ef ee fe en} 
+1 H 3 F ET j--+ ® . ” : 2 » * 
ee emcee er fom Sy H 2 a 2 » * s 
+? H H H ° r’ r P e * 
$e ee ft S eotenteateeh: Sendententendts, dautemtanteads deatenmentants. deatentomteedts 2 
+3 ; H ; #9 345 $ 46 5 47 j ; 
Sh ee ee se ae a me a + | $e ef ee fe ef oe ee em $ 
+4 H i; 3 
$e eee een yj Keypoint File FET 
+5 H H ; daca Sa a Saat 
$e eee eae —+t t----->} FILE NAME 3 ; 
+65 H : fe ne ae ne oe ae a ae an ne fp se wm sn a ne se sm ce fp 
Se Rae a sere t H H FIRST {-OBUFFER 
Parameter Block : osteatotententententetentediententadien foe eee eee + 
; H IN 3} 
pe an me ee ee on ee ee ne ee ee ee a oe 
; ; QUT 3 
Se ee cee ee a on a ee hae an ae ae a sn we 
; ; LIMIT $3 


Figure 1 


Program PMF js initiated by a RAt1 call which contains in its 
lower 13 bits the address of the parameter block. This block 
contains the keypoint selection and sampling paramaterss g 
pointer te the register 22 blocks and a pointer to a File 
Environment Table (FET). The FET In turn describes a circular 
buffer Into which thea keypoints are collected, 
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640 PME DATA COLLECTION (PPKPNOS» PKPNOS) 
O02 PROGRAM pele NOs 


402 PEQGRAN _BRKPNDS | 


The program PMF is loaded into a PP in response to a RAt+1] call. 
Once initieteds it will Insure that the CPU is a CYBER 170 model 
B25, 825% or 355 and that the PMF hardware option is installed. 
If the program detects any other copies of PMF runnings it will 
abort the calling program and then drops oute 


If no other copies of PMF are runnings the program will read the 
saven word perameter block pointed to by the lower 18 bits of the 
RAt1] call. The address of the register 22 block is then checked 
to insure that the block lies within the users field iength. 


{f the keypoint cecllection fiag is not set in word two of the 
parameter blocks PMF will iqnere the remeinder of the biock,. 
This enables the user to omit the FET and circular buffer if 
keaypoint collection Is not desired. 


PMF then checks the origin type of the calling program. If an 
interactive program has requested keypoint collections it will be 
aborted with an error message. {Keynoints may not be collected 
interactively as the CP program must be tocked into ¢M for the 
duration of the collection period.) It is possibile for register 
22 to be tloaded and dumped interactively for counter rode 
collection onty. 


beZe2 LOADING AND DUMPING REGISTER 22 


To start the PMF hardwares register 22 must be toaded with 48 
bytes of data. This initializes the hardware and begins PMF 
operation as specified by the control Fields In the data. To 
stop PMF hardware operation and to collect the sight 32-bit event 
counters contained in register 225 the register must be read and 
dumped to ¢™,. 


After initializations the program PMF determines from the 
parametar block whether register 22 should be loaded or dumped. 
If the user has selected foadings the araa in CM designated as 
the register 22 block fs read and its contents transferred to the 
PMF hardware@e If dumping is sa@leactads PMF is stopped and the 
contents of register 22 are transferred back to the register 22 
block in CM. 
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GeZe2 LOADING AND BUMPING REGISTER 22 


AD NN RUN NUE ED ANS SA AE OD ON AEN A AA UD ANNA SONOS AE OD NR OD NAD ONE AN OR ONES NN UND “OND SN AG A EE VRE WY AE ND ATR. ND RED SRO 5D A LON OUD WA OD OU OE ie SOY AND Ee A OS a Ee A ee ee ee 


If keyooint collection is not requireds the orogram PMF will 
restert its caliing program and drop out after loading register 
226 This permits the user to initialize PMF and to collect data 
in the counters without having the program PMF running at the 
same time. When the test Is complates the user then calls PMF to 
dump the contents of register 22 to CM, 


After a dump of register 22» the program PMF always restarts the 
calling program and drops. 


e203 KEYPOINT COLLECTION 


Aftar ftoedine register 22» the user may have the program PMF 
remain in the PP to collect keypoints. When colljlecting 
keypointss the Program enters a toop which consists of the 
following steps? : 


l. Teast for any condition that reauires the program PMF to 
stope This Includes a PMF hardware stops an error =iIn the 
CP orograms an operator droos or the operator command 
tn CFO.STOP."™. %&f the condition is not fatal to the ¢P 
programs termination processing is begune 


mW 
* 


Read keypoints from the PMF FIFO buffer to the selection 
buffer in the PP. If a sampling interval has been given in 
the paramatarss one keypoint is read after each interval. 


3, Select keypoints from tha selection buffer and place then 
into the keypoint buffer. Selection is based upon the 
keypoint selection mask given in the parameterse The user 
may also collect every nth keypoint of any given class 
according to the keypoint selection counts (sea section 
41). 


4. Write keypoints from the keypoint buffer to the circular 
buffer In cantral mamory. 


The CPU orogram may read the keypoints directiy from thea circular 
buffer or may perlodically issue CIO requests to empty the buffer 
to a File... 


The keypoints are placed into a circular buffer with one 8-bit 
byte per l2—bit PP oercel. The upper four bits of each parcel 
wea set to zero. Since each kaypoint is eight bytes in lengths a 
keypoint willl occupy one and three-fifths CM words in the buffer. 
exactly forty keypoints will fit into a single PRU, 
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Oe2e4 END PROCESSING 


end processing consists of dumping the last keypoints collected 
to the clrceular buffers and dumping the contents of register 22 
to the register 22 bliocke 


Keypoints are transferred from the PP buffer to the circular 
buffer on a PRU basis. When collection Is completes 8 bytes {one 
keypoint) of ones are added after the last keypoint if there is 
not axactiy one PRU of keypoints left In the PP buffer. This 
anables tha user to determine how many xeypoints In the last PRU 
are valid and serves as a delimiter. 


After dumping the keypointss the PMF hardware is stopped and the 
sontents of register 22 is olaced into the register 22 oalock in 
UM. Bit 2**9 of byte 0 of register 22 Is set to one when the 
register is dumped to CM. This bit is checked during kevypoint 
collection to determine if PMF eperation has stopped. 
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Ge3 COMMUNICATION BLOCKS 


603 COMMUNICATION BLOCKS 
be3ei PARAMETER BLOCK 


The parameter block Is seven CM words in ftength, The following 
pseudo-COMPASS describes Its format: 


PARBLK VFO Ll/Load_Dump_Fiag 
VFO & 4/9 (reserved for future use) 
VFD L8/Reg22_ 3lock Address 


PARSLK+1 VFOD l/Keypoint_ Collection Flag 
VFO lé/Keypoint Sample Fiag 

VED 1l/Keypoint Selection Flag 
VFO LT/Central_ Memory _PMF_ Buffer 
VED 4/9 (reserved) 
VED 1é6é/Keypoint Selection Mask 
VED lZ/Keypoint Sanple_Interyal 
VFD 6/9 {reserved) 
VFD LB/FET_Address 


PARBLK#2 VED 12/Setection_Count_o 
VED L2/Selection_Count_1 
* s 


» 2 


2 
YEO lz/Selection_tount_15 
VFD &8/0 {reseryed) 


PARRBLK+46 VED 60/0 (reserved) 
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Cn nr ee ee ei tee Bin tna erases ensadiiinaisieamentiaanen ieee meat ae Eo mE ae Rate atta Ea a ine Read 


9 PMF DATA COLLECTION (PPKPNOS» CPKPNDS) 
Goedel PARAME ETER idea 


987654321 0987654321 098 765432109876543210987654321098 76543210 


3 

4 
beet 

434 

$4) 


ey , Reg 22 address } 


ee od ab a a ae nab ae me Tae S stenettinadioante ot RD eR sea ent ME Oe a s ateretamatonets, stemmtantaateastaraic. sfenteniaantemstemdamstenmtanstenatenntaantetomatiakametentonan! + 


190004 Ket se! mask {Sample int.i00000% FET address ; 


Ben ote 0 } sel ae 1 i se} ctr 2 , se) ate 3 $ sel ctr 4 3 


sel ctr ® ! sel etr 6 $ sel etr 7 i sel ctr 8 $ sel ctr G 3} 


is al: 


pee ee ee 


nee ee nee 


a 
a 
+ 
* 
a 
% 
a 
rs 
4 
3 
+ 


2 


SA I A DE SEND EN OR AO SOO SON SE SO AN NS OD NE NN fp asco inte see A AN NE “AT RED Rh F ieetae Retain AE A A RO S cemmtanetoeiamntetententemtaemtonstceatte, 2 


> 
ctr 10 ‘ce bee 1 sel ctr 12 ;sal ctr 13 eo ctr ak ; 
+ 
4 
2 


A ae en sae a te A NN + 
etr 15 Reserved: H 
> Sm ae se ee ee er ee ee eee + 
Reserved : 

Tale ean ca i A ee A A A el a a ee OE ED I ee Oe ee eee ee ee ee ee ee ee ee ee ee ee 7 OD ee She OEE ES OS SO ARE oe NN le hie a a a ae ee +} 


Note that the selection count parameters occupy words PARBLK +2 
through PARBLK45. 


The 


parameters ares 


Load Dump Flag Tf set to ls indicates that register 


22 should = be loaded from the 
register 22 block. If set toa O» 
indicates that the eontents of 
register 22 should be dumped to the 
register 22 block In CM. 


Reg22 _B1ock Address CM address of the register 22 blicck. 


2 BA 


Kaypoint_ Collection Flag Set to 1 if the user desires the 


program PMF to remain In the PP and 
collect keypoints. 


Keypoint Sample Flag If set to 1 the program will read a 


single keypoint from thea hardware at 
intervals specified by the 
Keypoint Sample_Interval. 

Qtherwises al! the kaypoints are 
read, 
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603) PMF DATA COLLECTION (PPKPNOS»s CPKPNOS) 


ee se 


Kayrotnt_ Selection_Flag 


Central Mamory PMF_ Suffer 


Keyooint Selection Mask 


<avooint Sample_Inter vai 


e=T_address 


Indicates that the selection of 
kevpoiInts by keypoint class should 
be performed. Selection is based 
upon the Kaypoint Selection Maske A 
one in the mask at the position 
corresponding to class n indicates 
that the keypoints of class n should 
be collected. A zero in that 
position indicates that all 
keypoints of class n should be 
discarded. Note that the selection 
mask performs the same function as 
the Kaypoint Mask in a CYBER 13¢ 
exchange package. If possibies the 


exchange package mask should te used 


to minimize overhead. 


If set indicate that the Central 
Memory PMF FIFO buffer will be used 
instead of the hardware FIFO buffer. 
The CM buffer is one page long 
versus the 16 words of the hardware 
FIFO buffer. This buffer Is driven 
directly by the microcode, 


This mask determines which clesses 
of kaypoints are collected» and 
which classes are discarded (see the 
description of the 
Keyopoint_Setection Flag). The 
leftmost bit in this mask 
corresponds to keypoint class O» the 
rightmost bit to keypoint class 1%. 


In millisecondss the amount of time 
to wait between the collection of 
keypoints {see the 
Keyooint_Sampla_Flagde 


The CM address of the FET for 
keyopoint collection. 
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609 PME DATA COLLECTION (PPKPNOSs CPKPNOS) 


bed.l PARAMETER BLOCK 


Selection Count_na 


For a value ms avery mth keypoint of 
class n is collected (@ea- if 
Selection _Count_7 has a value of 3» 
every 5th keypoint of class 7 will 
be collected). If a value of 0 or j 
is specifieds all keypoints of that 
class will be collected, 
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60302 REGISTER 22 BLOCK : 


60322 REGISTER 22 BLOCK 


This block Is the Image of register 22 as it is read or written 
from tne PMF hardware. Register 22 consists of 48 eight bit 
bytes. To simplify the handling of these bytes» they are teft 
unpacked in the register 22 black» one byte In every 12 bit 
parcel of a CM word. When foading ragister 225 the upper 4 bits 
of each parcel is ignoreds and when dumping the register the 
upoer 4 bits are set to zeroe 


The following COMPASS code will generate the register 22 block: 


REG22 VED L2/Byte_0 
VED 12/Byte_l 
VED 12/Byte_47 
VFD 24/Reaseryed 
5 5 4 3 2 1 6 
9976543 210987654321098765432 1098765432 109876543210987654321¢ 
fm ee em fae nm no fa nn nn fe er enn fa nnn ne = + 


: oe 0 : Byte 1 i we 2 ; 3yte 3 H Byte 4 § 


+ Byte 5 i Byte & i Byte 7 + Byte 8 i Byte 9 ‘ 


$ B8yte 10 3 Byte 11 ¢: Byte 12 } Byte 13 : Byte 14 H 


$ 3yte 15 $$ Byte 15 {| Byte 17 $ Byte 18 H Byte 19 H 
pene eee ae $2 new ee eee ooo $e mew eee $e ewe eee + 
} B8yte 20 3 Byte é1 H Byte 22 3 Byte 23 } Byte 24 } 
$e eee oe ooo ooo $2 wwe eee $— owe ewe nw ewe + 
$ Byte 25 } Byte. 26 ;} Byte 27 + Byte 28 } avbe 29 3 


$e ee nn a fa en ow ow fn rn we rn fo en nn fe enn nnn wn = + 
; Byte 30} Byte 31 3 DAES 32 ; {Byte 33 { Byte 34 3} 
f— eee en fon eee ee eee $e tee een fe a $e ee + 
: ayte 35°C} Byte 36 6 “Byte 37 + 3y¥te 36 } Byte 39 } 


; men “9 ; cadichs 41 ; “pyte 42 % <3dyte 43 ; Byte 44 } 


; Byte 45 H avis 46 3 eyes af ; Reserved H 

fee a eee ee to <== <<< pone nnn we ee $< a a aa + 
Note that the register ¢€2 block occupies 10 CM words,» with the 
Jower 2 parcels in the last word being reserved for future use. 
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The CYBER 189 MIGDS contains 29 dataited description of each tyte 
in ragister 22. 


6e323 FET AND CIRCULAR BUFFER 


The FET and circular buffer used for keypoint collection ere 
identical to those used when performing normal 1/70 transfers, 
Thay may be created using the folfdowing COMPASS macros?’ 


BUFL = - EQU 60008 
FET FILES BUFF »BUFL 
BUFF = BSS BUFL 


The keypoint collection program was written to provide fast 
transfers of keypoints to the CM buffer. To facilitate this» the 
program assumes that the CM buffer is always (n * 1008) words in 
fenath (where n >= 3). If the buffer length does not conform to 
this rastrictlion»s keypoints may ba lost and data in or after the 
buffer may be destroyed. The PP will never write data outside 
the user's field length. The optimum buffer size for a 
particular aoplication will depend upon the rate at which 
keypoints ara issued and the amount of time needed to empty the 
puffer, 


It is the responsibliity of the CP program to insure that the 
huffer is amptied. The program may do this by perflodically 
issuing a CIO write request. Alternatelys the program may read 
the kevooints directiy out of the buffer and process them as they 
are being collected. If the ¢P program is to read the keyoolnts 
out of the buffers it must read onty intsgec_ multiples cf a PRU 
at a tine. 


If keypoints area being issued at too greats arate the circular 
buffar nay become full. If this buffer is not emptied before the 
PP transfers the next PRU of keypointss all the keypoints In the 
CM buffer willl be tost. Special checks are mada in the data 
collection software to detect such data toss and to fieg its 
OCCUrrences 
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6e4 PROGRAM CPKPNOS 


6.4 PSOGRAM_CPKPNOS 


Tha program CPKPNOS has been written to provide the user with 4 
means to collect counter and/or keypoint data from the PMF 
hardware. CPKPNOS» which is written in FORTRAN 5 and COMPASS» 
uses the PP program PMF to read and write register 225 the PMF 
control register. It then eroduces a fisting which contains 
hardware and software statistics. 


The default information provided by SPKPNOS Is? 


Central Memory Reads 
Caches Misses 
Cache Hit Rate 

Cantral Mamory Writes 
Total Memory Accesses 
Instructions Executed 
Run Time 

MIPS Rate 

9. Transfers to 1@0 State 
1d. Time in 188 State 

lL. Parcentage of Time in 180 State 


to) oO Ue + DIN 
* ss © © © © @ ©) 


In order to yive the user additional control over the control 
fields in PBF register 22» a set of parameter keywords are 
cprovided. These alse allow the usar to define the start and stop 
times for the PMF collection period, The following pages 
summarize the different control parameters for the data 
eo llection program. . 
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6.0 PME DATA COLLECTION (PPKPNDS, CPKPNOS) 

be4sl CONTROL PARAMETERS 


bGe4ei CIUNTPOL PARAMETERS 


All control parameters may be specified either by their full 
names or by a one te three character aboreviation. In the 
Following descriptionss the abbreviation is shown directiy 
beneath the full name of the parameter. Note that all tokens in 
the ogarameters suppifed to CPKPNOS must be separated by either 3 
blank or a comma. 


TYPE = <82GINT END COLLECT> Default = END 


3 2GIN = start counter collection 
END = stop scounter collaction 
COLLECT = start keypoint collection 
This parameter determines the type of data collection run. 


SAMPLETI®G = <n> Default = 6 
SAT 

Counter mode -~-- n is in seconds. 

Keypoint mode -=- n is in milliseconds 
This parameter gives the sampling interval. The sceie for 
the Interval given depends on whether counters or keypoints 
are being collected. 


STAR TIME = <hhemmd Hefault = 090.00 
STT ig 
This parameter is used to start collection at a specified 
time of days If its value Is "60.00"» collection starts 
immadiately. 


STOPTIME = <hh.amd Default = 06,00 
SPT 
This perameter jis used to stop collection at ai specified 
time of day. If tts value ts "00.00"» there is no stop 
tima processinge 


MACHINET9 = n> Nafault = 2 

MID 
This parameter is used to specfiy the machine model on 
which the collectien is running (Sl=l»s $2225 $353). 
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6.0 PMF DATA COLLECTION (PPKPNOSs CPKPNOS) | 
Gated Me sYPOINT SOELEG Een PARAMETERS 


be4e2 KEYPVINT COLLECTION PARAMETERS 


Parameters are used only for «eypoint recollection. Thus» 
Load Dumo Flag and the Keaysoint Collection Fiag are set by 


DePault 


it 
ee 
i 


3 ~< 
an, 


i 
oe 
iad 


N> Default 
fe Fi 


SLE = <YESTYINGIND Nefault 
Keyooint Selection Flags 


NO 


SLM = <n> Default = FFFF 
This parameter specifies the kaypoint selection mask toe ba 
us2d in conjunction with the SLF parameter, 


a 


SCt = <n> Default = 0 
This parameter gives the selection count for class i (where i 
is in the range ©..15). Note that i must be specified as a 
two digit number (2.9. 00 as In $000). 


More Information on these parameters Is found in the Parameter 
Block sectione 
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6e4e3 REGISTER 22 PARAMETERS 


e423 REGISTER 22 PARAMETERS 


The register 22 parameters allow full control of the varlous 
bytes In the PMF control register. Normally these do not need to 
be used as appropriate default values are selected; A1L7O state 
data for counter collection and 180 state data for keypoint 
collection. 


cach parameter is used to set an B=bit control byte in register 
Le» A complete description of tha effect of the various control 
aotions is given in the MIGDS. Note that thera are no parameters 
to seat bytes 0» &G» and F of reaister as thase are always preset 
TO 7Zeroe 


CTL = nlen2+n3 3yte 1 control 
n3 Stoo oan keypoint class Qefeultss 
Af otart keypoint operation counter moda = 
nl °MF keysvoint raquest kKeyooint mode = 


SKo = al¢en2 Ayte 2 control 
Qefeaults? 
ni Start keypoint class counter mods 
n2 Stoo kaypopoint class keypoint moda 


ao 
be 3 
“py lt 


i? 
ts 


dQ =n Byte 3 contro] 
Defaults? 
counter mode = FF 
kKeypolnt mode = FF 
Fach bit set in SCO will cause PMF to terminate orocessing 
if the corresponding counter overflows. 


PIA =n Ryte 4 control 
Defaults: 
counter mode = (2 
keypoint moda = 04 
This varameter gives the Processor Instruction Argument for 
instruction counting. 


PIM =n Byte 5 control 
Defeults: 
counter mode = FF 
keypoint mode = FF 
This parameter gives the Procassor Instruction Mask for 
instruction counting. 
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60403 REGISTER 22 PARAMETERS 


SAO 


ate 
p> 
Ed 


5B2 


n Byte 8 control 
Defaults: 
counter mode 
keypoint mode = Cl 
This parameter glves the event/state selection eede for 
counter AG and the control bit to AND counters AO and 2O. 


i 


n 8yte 9 sontrol 
Nefaubts: 
counter mode = Ct 
kaypoint mode = CC 
This varanete gives the event/state selection code for 
counter 


counter ode = 5 
. keyootiat mode = ¢ 

This vtaraweter gives the avent/state sgatection eecde far 
sounter Al ane the control bit te AND counters Al and al. 


n Syte ll control 
Defaults: 
counter mode = CC 
keypoint mode = O6C 
This parameter gives the evant/state selection code for 
counter 81. 


n Byte 12 control 
Defaults: 
counter mode = 11 
keypoint mode = O07 
This parameter glves the avant/state selection code for 
counter AZ and the contro! bit to AND counters A2 and B2. 


n Byte 13 control 
Defaults: 
counter mode ce 
keypoint mode U3 
This parameter gives the event/state selection code for 
counter B32. 


n Byte 14 control 
Defaults: 
counter mode = Gl 
keypoint mode = 9¢ 
This parameter gives the event/state selection code “for 
counter A3 and the control bit to AND counters A3 and B22. 
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Ge PMF DATA COLLECTION (PPKPNOS»s CPKPNODS) 


383 


faa. 


fy * & 2 


il 


n 


te 2 ’ ee es 
This per amater 


caunter a2, 


Tals 


wi 
* 
4 
3 
i$ 
i 
ie 
“| 


gereneter 


parameter 


perameter 


ogramater 


faremater 


narameter 


initializes 


initiatizss 


initializes 


initializas 


initiaiizes 


initializes 


jnitiatizes 


Byte 15 contral 
Yafaults2 
counter 


satesction eaades 


Bytes 1o~19 initiatize 
Default = 106 
ceuntar AO to the vaiua ne 


Sytes gets jinitializ. 
Default = Loo 
counter B&O to the value ne 


4ytes 25-?7 iInitialivz. 


Jefault = Loo 
counter Al to the value ne 


Bytes 28-31 Initializ. 
Default = 10¢ 
counter Bl to the value n. 


Bytes 32-35 initializ. 
Default = 160 
counter A2 to the vaiue n. 


Bytes 35-39 initializ. 
Default = 100 
counter 2 to the vatue n. 


Bytes 40—43 initialtiz. 
Default = 106 
counter A3 to the value n. 


Avtes 44-47 initlaliz. 
Qefault = Los 
counter 83 toe the vatue on. 


Fontrol Xeta 


Kevyopoint mode = 34 


for 
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$a 


fete4ei Inout Files 


Oe%e4el InoutEiles 


PARMEL = <Filea name> Default = INPUT 
Example: 
TYPE = BEGIN 
MTO 
SAC 


1 
7 
a OS 8 C 


wow tt 


This File contains the data cellection parameters. 


bete4e2 Qutput Elles 


REPTFL = <File name> Deafault = OUTPUT 
This output file contains the collection report, 


DEBGFL = <file named Nefault = FoaG 


This Pile will contain debugging information such as the 
Reg.22 and the parameter biock dunps. 


KPTS = <KPTS> Default = KPTS 


If kevypoint coliection is selecteds the keypoints coliected 
will be outputted on file KPTS which Is currently a hard 


coded name. 
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6.5 OUTPUT REPORTS 


6.5 QUISUL_gEeoRTS 


The only outout report issued by CPKPNOS is a counter summary if 
counter collection is selected. No report is Issued for keypoint 
sollaection as these reports are produced by the PMF Data 
Reduction softwares. . 


6e5.1 COUNTER SUMMARY 


SYSTEM STATISTICS = $2 B2/AL/ 1b. 17601elb. 


CENTRAL MEMORY STATISTICS 


ey co 8s 


INSTRUCTION =XeCuTITION STATISTICS 


S7OI9HT7 Se 
Xe 4G O47 > 


SYECUTIVE PRIGRAN STATISTICS 


WANT EEE 
tT HANS PE 3 


AVG. TIME 


KiQuUTive Z551L613e 
eX CUTIVE eS 


TITAS } 53 
RUN TIME (56. 
PERCENTAGE IN EXECUTIVE 
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6.6 OPESALIONSL PROCEDURES 
be6e1 INSTALLATION 


To Install these programs three files are needed: PMFPL, XULIB 
and PMFPLTIR, To compile and sysedit the PP binary type: 


SES«¢PMFINST PPKPNOS 
SES .GETMEM OMF PP B=XULTIS 
SYSEDIT> B=GROUP. 


To compile and save the data collection program type: 


SES sPMFINST CPKPNOS 


6e5e2 RUNNING THE DATA COLLECTION 


To begin the collection of statistics,» a job must be submitted 
with the data card TYPE = BEGIN. This will initialize register 
22s and start the event counters In the PMF hardwaree When the 
test perlod Is compietes resubmit the job with the TYPE = ENC 
data card, The event counters wilil be read from PMF and the 
program €PKPNOS wilf output a Jisting containing the statistics. 


The program CPKPNOS may also be used for the collection of 
keyooints from the 186 side of the machine when Dual State is 
running.e 


While collecting keypolints» tha job will normally remain at 4 
contro! point until PMF hardware detects a stop condition 
(counter overflows stop keypoint). The job can be terminated 
prior to this by the operator command "n.CFO.STOP". Normal end 
processing is begun by this antry and the keypoint file wil! be 
corractiy produced. If the job Is dropped» the keypoint file may 
not contain all the desired keyoolnts and will not be terminated 
by the record which contains register 22. 


If keypoints are [Issued too rapidivs the buffer in CPKPNOS may 
become full. If this happenss keypotnts may be loste While this 
problem is unlikely whan the file KPTS is assigned to disks it is 
a oassibility if the keypotints are being written to a tape. Nao 
error ma@ssage is currently issued if keypoints are Jloste 


Tne kKeyoosint file produced by CPKPNOS can be input direactty to 
the xevoolnt prae-processor program (KPPRE). 
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Bi 


Se6e3 CPKPNOS RUN PROCEDURES 


An 3"*5 orocedura 'PME! js supplied. It Is recommended that this 
proc be installed on user number SYSTSMX or LISRARY In order to 
allow the operator te initiete a data collection by typing: 

xePMF (parameters) 


ahere the parameter descriptions are as follows: 
KEYWORD QESCRIPIION VALUE | DEEAULT 


TY type of collection COLLECTIBEGING END END 

MI machine type $1192133 | $2 

IF input parameter file File name none 

OF statistics output file file name NCPKPNS 

TPF tape number tape ysn none 
(if collection on tapes 


otherwise the disk 
File KPTS Is assumed) 


a3 


De tape density PEsGEseatce PE 


LI8 library containing. fib name XULIB 
XCPKPNS In ULIB Format 


LIBUN user number where user id KEYPERF 
fibrary is located 
Soma examples of how to use PMF Follows 


SES.PMF TY=BEGIN This call initiates PMF counter 
; collection. 


SESe PME This call terminates PMF counter 


collection. The output will be 
found on file OCPKPNS. 
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625.3 CPKPNOS RUN PROCEDURES 


SES+PMF TY=BEGIN IFSINFILE 


ESePMF TY=COLLECT 


SESsPMF TY=COLLECT TPF=ARCS 


901 


This call witl initiate a PMF 


counter collection using the 
input fiie INFILE to change some 
or all of the Reg.22 satting. 


This call Initiates PMF keypoint 
collection. The collected 
keypolnts wil! be found on File 
KPTS. 


This call initiates PMF keypoint 


collections Thea collected 
key ooints will be found on tape 
ABCOO1. 
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Tey KEYPOINT DESCRIPTION PARSER (KPPAR) 


7.0 KEYPOQINI_QESCRIPTION PARSER _(KPPARD 


This program was originally Imbedded Into the oere-processor 
program. For obvious reasons of radundancy a stand atone program 
has been bullt. This approach was choosen because the need of 
parsing the common decks Is only when changes to the common decks 
are donee. Thus» every time tha pre-processor is used» there Is 
no need to re-parse all the common decks. 


TAis eprogrem parse the kaypoint common decks and genrates a more 


concise hinary file which the pre-orocessor will use over and 
OV ers 
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700 KEYPOINT DESCRIPTION PARSER (KPPAR) 


Tel KPPAR_ GENERAL. DESCRIPIION 


The orogramn reeds the keyoolint comnon dacks and creates a hinery 
file summarizing the keypoint descriptionss for us2e by the 
pre-processor, It does also check the syntax of every 
description according to the Itlanguage specification. Error 
messaaes will be printed accordingly. 
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7.2 QESCRLELION_OE_EILES_USED 

7.2.1 INPUT FILES 

PARMFL3 This file contains the input paremeters for the control 
of the program. | 


KEYIeSC?: This file contains the kevpoint common deck descrioptians 
needed for the processing of the keypoints. 


Te2@eZ QUTPUT FILES 


PARSFL: This file contains thea parsed descriptions cof the 
keypoints. The parsing produces a file of descriptions of the 
Following format: 


5 5 3 1 Cc 

9874 432109876543 2109 997654321098 76543210937654321098 75543 210 
eaten ioe tanienteetenteedinarientemten metentmanentemmmmeendanteneatentententaatentatententantanteamentestedenentententantensemeatetentententmeatenmetenteatetenten + 
; paveolnt desoriotion - sepa l ; 
$e ee ee ee ee a ee ee ee ee ee ee eee ee 4 
H Weed oupaien deseriotion ~ word 2 4 
a ae oe ae ee a A eA A 8 + 
; keypoint description - word 3 H 
‘fee sane se ew san sie nan sae Ho A SA A SS A A NS A eS Sa A A A “A Nn Se A mh es ae a Se eS 
; pay soine descktoeion - word 4 H 
} keypoint deserietion - word 5 H 
Sf ee a ee me ae en ae Se ee A + 
H keypoint descriotion —- word 6 H 
: keypoint description - word 7 } 
A ee SA A A A NO SS A A A OA NS A A oe ae ee oh 
; keypoint description - word 8 H 
ee ne ee a ne ee ee ee ee ae ee en a ae 
; data identification - part 1 H 
ee ee ee A A A HE NN He A SH ee te A LS A A SO EE DD i ON SO A SD HD a em ‘Da see ome he 
H data id = part 2 ee 
$a ae ee ee ee fee ee ee pe} ef ee pee fee ee fee eee ee $f 
H a ; b sci gd} a 3 t ; g H h :3 
‘he ee ee are se ee | A ND hn TE ON HO END ae aD eee ee A A A NE NN EN a Le ee en ee ee ee ‘tte ane aan aun en an eS ne ee ee ee ee ee ae ae 
; count inceger) : 
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7o202 QUTPUT FILES 


AN SAAS SRR RR ile SOND Shin eek SAAD INR OER NAAN Sant calls ANN ail NNR NN <A: AND NR ALN RO septal A TE END SND SI ER EN GEA PNR “ANN EE RRND TAD ED ND een AND OA AEN OED AR RD A ER AONE <n AD Agi SI ED SE AUD NE SE - -A  e 


Where: 


oe | 


~ keypoint number » 

- sub_id match values 
~ data formatting» 

~ sub_id metch length 
data length» 

~ kayrpoint class» 

~- spacial case flag» 
~ dascription index» 


Jato ao yp 
J 


DEBGFL: This file contains some permanent debugging information. 
Alsos fists input IJines which do not conform to the language 
specifications together with an axplanatory error or warning 
messagese . 
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7e3 DPERATIONAL PROCEDURES 


763 QRESATIONAL PROCEDURES 
Fe3el INSTALLATION 


To Install this program three files are needed: PMFPLs XULIB and 
PMFPLIR, To compile and save the binary of the parser program 
type? . 


SESsePMFINST KPPAR 


7eo302 KPPAR RUN PROCEDURES 


An SES proc file is supplied in order to run the parser program, 
This eprocedure willl genabie the user to execute the prosgrar 
locally or submit a batch job. The following parameters ara used 
within the procfile. | 


Any of the parameters defined In the SES module JOBPARM may be 
used. Thase Include JOBTLs JOBFL» JOBCN», JOBPRs» JORUN» JCBPWs 
JOBFAL Ys JOBONs JOBPN»s LOCAL» BATCHNs BATCH» DEFER» NOLDAYFs 
DAYFILEs AND OF. (See SES Procedure Writer's Guides Appencix A). 


PRE: Parsed k eypoints common decks fille. This file is the 
outeut file From KPPAR. 
Examptea PRF=PARSFEL Default PAPRSFL. 


COF This specifies the name of thea file containing the 
common decks. If no file is assigneds KPPAR will 
attempt to get the common decks using file KEYDESCT in 
user number DEVI. 

Sxample CDFZKEYD Default KEYDESC, 


ID If the the preprocessed kaypoint data file is in another 
user's area this parameter nust be specified. 
Exempla ID=PM72 Default KEYPERF, 


LIB Name of file where the object code for XKPPAR is found. 
Irdinarily this parameter Is obtained from the ttooltibt 
parameter in the user's PROFILE. This parameter would 
ordinarily be used for testing a new version of the 
preprocessor» or for use of a specially modified version 
of the preprocessor. 
examofe LIB=MYLI3 Default XULIB. 
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7e9 KEYPOINT DESCRIPTION PARSER {(KPPAR) 


Te3e2 KPPAR RUN PROCE DURES 


PA AE AD ND A ND A ND DS EN SD A OD EE MO TN 


LIRBUN User number where file specified by LIB above) resides. 
Irdinarifly this parameter Is obtained from the fteelact? 


parameter 
Examofte LIBUN=UN1L2 


In the user's PROFILE. 


Default KEYPERF, 


Some examples of how to Invoke the KPPAR procedure follow: 


SESSKPPAR 


SESeKPPAR LOCAL 


This call wild parse file 
KEYDES¢C and the parsed output 
will be found Into file PARSFL. 


This call will run intercatively 


the job with the same default as 
In the previous exemple, 
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BeG KEYPOINT PREPROCESSOR (KPPRE) 


I_PREPROCESSOR (KPPRED 


The keypoint pre-processor KPPRE is designed to take NOS/VE 
Keypoints and the parsed keypoint common decks file as input and 
to produce an output keypoint file sultabie for input to further 
data raduction stagese Tt will optionally output a formatted 
keypoint trace report for systen debugging ourposess Another 
capability Is to produce a printable keypoint descrietor file 
automatically generated from the Input binary oarsed file from 
the NOS/VE program ftibrary(s). This descriptor file may contain 
descriptions of all keypoints or only of those keypoints found or 
the keypoint data file. When keypoint ore-processing is 
selecteds the compressad description is always the first record 
on the keypoint output file. This approach was chosen to 
minimize «keypoint maintenance and scoordination problems. 
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8.0 KEYPOINT PREPROCESSOR (KPPRE) 

8.1 KPPRE GENERAL DESCRIPTION 


Sel KRBRE_GENERAL_ DESCRIPTION 


Tha KPPRE orogram will eccept simulators softwares or hardware 
coilected keypoints and the NOS/VE keynoolnt common decks fille as 
input ands depending upon the Input parameterss will generate any 
combination of 3 


9 keaypoint trace report 
o ka@ypotnt description file 
0 pre-processed keypoint data Fila 


[t has the capability of outputting trace reports and 
Pre=orocessed output files for a!1!] kaypoints encountered tn the 
data or only for those belonging to a specified task. Processing 
may also be turned on and of Ff on givan keypointse 


KPPRE was created by modifying and amalgamating three existing 
keypoint processing programs. In the process», a8 number of 
existing bugs were corrected and the user interface improved and 
made SCL like. This program was written in CYBIL=-CC In order to 
simolify its eventual migration to CYBIL-II under NOS/VE. Tt 
currently runs under 170 state NOS versions 1 and 2. 
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8.09 KEYPOINT PREPROCESSCOR (KPPRE) 

8.2 CONTROL PARAMETERS 


3+2 COMLEIL PARAMETERS 


Al! control parameters may be svecified by elther their full name 
or by & one to three character abbreviation. In the follewing 
desecriptionss the abbreviation is shown directly underneath the 
full parameter name. 


FILETYP= = <SIM{USOFTPHARD>D Default = HARD 
FT 
This parameter specifies whether the input keypoint file is 
fron the C189 simulator or from software or PMF hardware 
collection under NOS/VE. 


DeSl = <YESNDLYIND Default = ND 


This parameter specifies that a keypoint descriotion file 
Is to be output. This file «ai1l be used as input to 
further data reduction programs, 


COMPDESC = <YESING?YIND . Default = NO 

CDS 
This parameter specifies that a keypoint description file>» 
containing only the descriptions of the keypoints 
encountered in the Input files Is to be generated. It Is 
put down as the first record of tha keypoint output file. 
Note that this toggle is forced on if pre-processirg is 
raguested since the deta reduction will not work without 
the compressed description. 


TRACE = <YESINOIYIND Default = NO 


This parameter specifies if a trace report is te be 
ganer ated. 


PREPR = <YFSINGIYIND Default = YES 

p 
This parameter specifies that a pre-processed keypoint file 
is to be generated. This file will be used as irput to 
further data reduction programses The compressed 
descrintion toggle Is forced ONe The compressed 
description is the first record on the output file while 
the processed keypoints are the second. 
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TASKID = <n> where n is # numeric task ID Nefault = -1 

TK 
This parameter is used to output all keypoints belonging to 
the specified task onto a file for further processing. [ts 
base may be specified in osrentheses after thea numbers 
example: 18416) = 24(10). This file may then be used as 
input to the data reduction programs.e 


SK TPKPT = <n> where nis a numeric value Default = 9 
SK <2=99999999 


This parameter is used to skip n keypoints at the beginning 
of the Input File. (Note that this count is not exact as 
trae number of keypoints skipped will be the next larger 
multiple of the number of keypoints per buffer.) 


MAXKPT = n> where n is a numerle value Nefault = 99999999 
mK €2=99999999. 


This parameter is used to specify the actual number of 
keypnints to be pre-processed Cexcluding any skipped by the 
SKIPKPT parameter). 


START = <x> <y> where x is a class noe and Default = -] -] 
STR y a kaypotnt no. 


This parameter specifies the Keypoint to turn cyclicaliy 
the pre-processor on, This parameter override the task 
Selection. | 


STOP = <x> <y> where x is a class nee and NAefault = -] =] 
STP y a keypoint no. 


This parameter. specifies the keypoint to turn cyclically 
the ore-processor off. Thts parameter override the task 
selection. 


Note: Yt Is not advised to use start/stop toggling at thea same 
time as task selection because the task entry keypoints will onty 
be recognized if thay fall within the intervals defined by the 
Start and stoo parameterse 
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8.0 KEYPOINT PREPROCESSOR (KPPRE) 

8.3 FILE NAME PARAMETERS 


z_NAME PARAMETERS 


DATAFILE = <file name> Default = DATAFL 

OF | 
This perameter specifies the Input file in which the 
collected keypoints reside, 


PARSFILE = <file name> Default = PARSFL 

PF 
This parameter specifies the input File where the binary 
parsed descriptions reside. For mora details see KPPAR 
secticne 


KPTFILE = <file name>d Default = KPTDFL 
KF 
parameter specifies the ore-processed keypoint outout 


TAis 
lle For Purther precessing by the deta reduction programs, 


f 


TRACFILE = <file name> | Default = TRACFL 

TF . 
This parameter specifies the output file for the trace 
reoort. 


TASKFILGe = <file name> Default = TASKFL 
TKE . 
This parameter specifies the name of the output file to 
which pre-processed keaypoints for the task spacified by the 
TASKIOD parameter are to be written. 


KLUGFILE = <filie name> Default = KLUGFL 

KLF 
This parameter specifies the name of the Input file which 
the pre-processor checks to altar the keypoints It reads in 
to make them Fit the descriptions the pre-processor haSe 
It is a measure to provide a temporary fix for 
discrepancies between the keypoint common deck descriotions 
and the actual implementation. 


Note that two file names ara scurrentiy hardecoded. The input 
Parameters are found on File "PAR MFL™ and debug outeut Is written 
to file “DEBGFEL*, 
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5e4 DESCRIPTION OE_EILES USED 
Be4el INPUT FILES 


PARMEL: This file contains the Inout parameters for the control 
of the axecution of the program. 


DATAFL: This file is a binary file composed of eight lz<hbit 
parcels per keaypotnt (see Data Collection for more informaticn). 


PARSFL?2 This File contains the parsed keypoint descriptions. 5ee 
KPPAR sastion for more details. 


KLUGFL?: This file is used to radafine keypoint descriptions and 
Incompatibile keyooint entries between the common decks and the 
actual cod®. 


Language specification for the kludge file: 


kludge _file z3= £ <kludge> ...] 

kludge t2= <oldiciass> <soe> <old_kan> <spco> 
<k ludge_action> 

old iclass 23= <class _range> 

class _range tt= 0.00 (16) 

old_kon $3= <kpn_or ange> 

kon _rang2 t3= 0,-0FF7(16) 

kludge_action t= BD <eol> } 

? C <spe> new _class> <spc> <new_kpn> <eol> } 

CO) € <spe> <match vaiuea>d] <eol> 
<keypoint descriptor> 

new class 232 <class _ranga> 

new _ kon B8s= <kpn_range> 

match value 23= O.2.0fff(14) 

keypolnt descriptor %%2 as described in IPNDOC appendix 0.1.5 


Example of a kiudge File? 
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49G1 ¢ 3 4901 
4001 €¢ 2 4901 
761 4 

761 4 

1654 © 4 1654 
250 €D 

Ee 'elotold data tength was 48' 'scommand' A2G 


1105 cd % 
X 4.9 'cha desc wif mtcheval» add data field’ tsagment! 416} 


rat & APG Po 2 oD to iho 


Control Data Private 


8sG KEYPOINT PREPROCESSOR (KPPRE) 


Be4.2 QUTPUT FILES 


KPTOFL: This is an output file containing the legible 
comoressed descriptions ja the first record and the 
pre-processed keypoints in the second in tha form of pairs of 
wordse : 


The descriptions are parsed from the common decks inte the 
Following format: Indexs Section Ids Class Noes Kons Match 
Values Match Lengths Flags Data Lengths Data Formats Data Id» 
Indantations Message. 


The second racord consists of binary pairs of words (for the 
hard keypoints) containing Information as shown In the 
Aitagram below. 


5 3 4 3 2 1 C 
9876543210938765432 10937654321098 765 4321098 765432109876543216 


$05 timer icl.i desc Index iflags t/44/173 
; data value tkeyopodnt mols IITA a esas era sss sds} 


Where: 
9 ~ buffer overflow Flag» 
$ - software lost data flag» 
flags: MOCT IT» 
M -— 180 monitor mode (1 bit)» 

D -~- split data flag {1 bit)» 

© - 170 state (1 bitds 
Tj - job trap handler (2 bits)» 

Tm - monitor trap handier (2 bits). 


TRACEL: This file Lists ali keyooints encountered and all the 
data which they were carrying. This iInciudes timess delta 
timess kpt numderss classes» task numberss modes» datas deta 
formats, section and messages Some of the Informstion is 
drawn from the corresponding descriptor entry. 


If a soecific task has been requested then only the task with 
the requested task number will appear In the trace file. 


Tha trace file also contains summaries of the kevroint 
descriotionss the undefined keypoints encountereds the number 
of xkaypoints encountereds the hardware and software overflows 
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Se4e2 QUTPUT FILES 


and how many were deleted from the output file. 


TASKFL: This file Is in exactiy the same format as K«FTDFL 
axcapt that oniy those keypoints Found for the specified task 
are written onto the second record. It Is Intended to be 
used as input into further data reduction phases when only a 
singia task is of interest. 


QESCFL3 This file contains the compressed kaypoint 
descrictions for ail the kaypoints in the system or oniy the 
keypoints which are in the collection file (see parameters 
OSC or CDS). | 


DERGFL: This file contains a listing of the parameters» and 
othar debugging informations If the trace toggle is set 
there may be disagnostics for monitor and. trae entry/exit out 
of sequence, 
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Ge KEYPOINT PREPROCCSSOR (KPPRE) 


8e5 QUIPUT REPORTS 


8.5.1 KEYPOINT TRACE 


Delta T DATA Ci Kptn Tro Task 


iA 
és 

or 
sca 


Ty Description 


Tine 


4925 
4955 
5525 
$583 
3606 
5699 
5819 
59% 2 
5952 
6062 
6148 
6158 
6161 
6165 
6192 
6205 
6303 
6333 
6368 
6411 
6420 
6513 
6731 
6957 
7046 
7481 
7557 
7606 


7633. 


7651 
7653 
7862 
7898 
7929 
8059 
3185 
8195 
3301 
8419 
8423 


8? 
29 
5370 
58 
23 
219 
123 


sa A Rs on RD AR OM DEO SRN oie ol ow eee oD OO Ube Ml De oD lin oi ll nD wR bn a Rn 


MCR 
task_id 
fid.ord 


Fha 


status 


status 
status 
fid.ora 
op 
fid.ord 
status 
status 
status 


fid.ord 
Fideord 
stetus 


status 
fid.ord 
09 
Fid.ord 
foe 


status 


OW & DAF POI Be ORO WW fo PO ug TM Oo UW) a Gd he DO OF WO OD OS Us be Ww Ob I GS IN os WS fo NG 


4001 
4002 
4002 
4601 
171 
4095 
152 
152 
152 
171 
i71 
3954 
16 
48 
157 
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Mtr. 
17 
17 
17 
17 
17 
17 
17 
17 
17 
17 
17 
17 
17 
17 


Sane Sass Cree Conmy Coan Cams Com Cain Co Circe Cir Crm Seer Cin, Crane Canney Come Cs Cn try Che Si Came Cine Cem Caste Cone Son i one Cy Cm Cee Cos Ci Kaw OS OD SE 
pt 
anal 


ENTER 180 MONTTOR woe 
ENTER NOS 1706 
EXIT NOS 170 
EXIT 289 MONTTOR MODE 
baptget next 
**¥* UNEXPECTED 
baotblock managar 
HEEKEEKE UNDER TNED KEYD 
baptblock_ manager 
HRKEKKEKE UINDESCTNEN KEYO 
baptget next 
¥xk* UNEXPECTED DATA KPT. 
ee UNEXPECTED DATA KPT 
kX UNEXPECTED DATA KPT 
bapftcontro! Status = 0 => na 
ampSget_next_ key 
ampifetch access _ Information 
baptcontro!] 
bapotfetch_access_in*®o 
beptfetch_ sccess_in*fo 
baptcontro! Status = 9 => an 
ampdfetchaccess_information 
cileptget_data_line 
clotget_ commend oriain 
cip$get_command_origjin 
amptput next 
validate _caller_privileaqe 
validate _caller_orivilage 
pmptget_task_id 
pmp$find_executina_taskuxs 
pmogget_task_id 
amp$put next 
bap$contro! 
bhaptput next! wsas ws! 
baetblock manager 
KEAKKEKEKK UNDECINED KEYD 
bap$block manager 
WXREEEEE UNDESTNED KEYS 
baptput next: ba 
*kk UNEXPECTED DATA KPT 


DATA KOT 


Ses COM Sore es SS me Tet oe Ph oe et em et tt a oe be 
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BeO KEYPOINT PREPROCESSOR (KPPRE) 

BeSe2 KEYPOINT SUMMARY 


8e5e2 KEYPOINT SUMMARY 


KEYPOINT SUMMARY 
Count Sect Cl Ty Kpn Message 


Ee 101 ampSaccess_ method 

LGl amptaccess method 

1695 amp$close 

i1¢5 amptctose 

iC& amposcopy_fitea 

198 amptcopy file 

111 amp$fatch 

Lil ampsfetch 

112 amp$fetch_access_information 
L1l2 amp fetch access_information 
Lis amptsfetch fan _pointer 

1i3 amps$fetch fao_polinter 

117 ampsget_file attributes 

117 amp$get_file attributes 

119 ampS$get_next_key 

119 ampSget_next_key 

1Z1 amptget_vartiel 

121 ampt get partial 

125 amptopen 

125 amptopen 

127 amptout_ direct 

127 amp$pnut direct 

129 amp$outclnext 

129° amp$put_lnext 

13G ampteut_partial 

12 amp$put_lparti al 

123 amptreturn 

1323 amo$return Status = 0 => normal 
146 ampSstora_fap_pointer 

146 amp$store fap_pointer 

148 validate caller privilege 
148 validate_calier_privilege 
1463 osptsat status _abnormal 
14C3 osptset status abnormal 
1404 osptappendustetus_parameter 
1404 osptappend_status_parameter 
1405 osptappend status_intager 
1405 osptaopend_status_integer 
1447 allocate 
1448 free 

152 baptbtock manager 

122 bap$hbiock_ manager 

155 hap$close 


| 
Reb ch on OF Oh PR oe a 
> 
=z 


29 = AM 


Fo 
= 

N ooh & 2D Gf Goh us PO us Po to fo G3 Bo bo P32 wo NM Gs Po Go AO Od Po GS fhe de NG) PO Ge IG) Po 65 po to Po gs MN 

wih OO M< i ST Mm << Woe TN Oe SP oe Pn Se TT WOO TE ok Ph OK TTD Oe ft << PT &< Fr > tft OK PTT 
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BoG KEYPOINT PREPROCESSOR (KPPRE) 


A AA ON AA AON A NNN NR DNS ESD NNN AERO SRY AEN SAAD AN NA Un NE SAD ENS SS ONES INN Aha NET EE SER ANN AR SOND CAND AA AD ND NED UP ND 2 OE eS RS TY EE UE AED A SD SES OD HD ED ED ED ND RN OO OE Ge A ee ae 


8e5e3 UNKNOWN KEYPOINT SUMMARY 


UNDEFINED KEYPOINT SUMMARY 


Class Kaynpoint Count 

15 0 z 
165% 1 
1132 3271 
1132 3271 
1133 3271 
1133 3271 


he 


a Tw PG 


TOTAL KPT PROCESS &D 

DELETED KPT 

TOTAL <PT ON PROCESSED FILE 
TOTAL UNDEFINED KEYPOINTS 


219118 
o 
219118 
13037 


“out w# 
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846 siceiceaian sai ill 
8.601 INSTALLATION 


To instail this program three files are needed? PMFPL» XULIA and 
PMFPLIB. To compile and save the binary of the pre-processor 
program tyoe? 


SESsPMFINST KPPRE 


Bebe2 KPPRE RUN PROCEDURES 


An SE5 pros flie is supplied in order to run the pre-processor 
erograme. The following parameters ar2 used within the proctile. 


Any of the parameters defined In the SE5 module JOBPARM may be 
useds Tnese inciude JOBTL» JOBEL» JOBCNs JOBPR»s JOBUN»s JOBPW>» 
JOBPMLY, JORPBCNs JOBPN» LOCAL» B8ATCHN» B3ATCHs DEFER» NOLAYF> 
DAYFILEs AND DF. (See SES Procedure Writer's Guides Appendix A) 


TPF If the raw input data is on tapes TPF Is used to specify 
the VSN(s) of thea tapeals) on which the data is found. 
If the V3NCs) have fteading 6s the VSN must be enclosed 
in singie quote marks, If the data is spread across 
more than one reels the list of VSNs must be enclosed In 
parenthesis. Up to 10 reals of tape may be specified. 
Tapes must he labeled. 
Ewample TPF =('000123's123455) Default none. 


OTF [? the raw keyooint data is on mass storages DTF 
specifies the file nama in which the data is stored. 
The file may be locals direct accesss or even indirect 
access although the tast aiternative is usually 
impractical. 
Example DTF=DATAFL Default DATAFL. 


DSF This parameter specifies the file «here the keypoint 
descriptors will be stored, 
Example DSF=DESCFL Default none» 
required parameter. 


PRE Parsed keypoints common decks file. This file Is the 
output file from KPPAR,. If the PRF file is not found» 
KPPRE runs KPPAR to create one. 
Example PRF=PARSFL Default PARSFL. 
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Be KEYPOINT PREPROCESSOR (KPPRE) 


RUN PROCEDURES 


KLF 


KPF 


SF 


TKF 


SKP 


mK P 


5TR 


This parameter allows spacification of a file containing 
information about keyooints which should be ignored or 
erroneous {usually because they are improperly 
installed). ; 
example KLF=KLUGFL Dafault KLUGFEL. 


This parameter specifies the file on which the 
preprocessed Keypoints willl be stored, 
Exampla KPF2KPFI Default KPTCFL. 


This parameter allows the V3N(s) of an output tape on 
which the preprocessed keypoints will be stored. Note 
thet SVF specifies onty the VSN{s)»s KPF Is still 
reaquireds atthough KPF is now the LEN of the tape. Up 
to 10 VSN(s) may be spacified.e 


my of 


Examole SVF={'O0G0123'!s'900456') Nefault none. 


This parameter specifies the file name for the trace 
File wnich stores diagnostics and data about the 
keypolnts. 

Example TRF#TRACFL Default TRACFL. 


This parameter specifies a preprocessed keyooint File 
for @ selected task. 
example TKF=TASK1 Default TASKFL. 


Number of keypcints to skio at the beginning of the raw 
kaypoint file. 
Exampie SKP=1000 Hefault oO. 


Maximum number of keyooints to process from the raw 
keypoint deta fila. 
Example MKP =2060 Default 99999999 


Start class and keypointe This parameter allows 
saarching the raw keypoint data fila to the point where 
a keyvpoint cf a given class is found, The format is 
'CLASS KEYPOINT!. Space batween class and keypoint is 
reaulred. See note on cycling In STP description. 

Examola STR=*% 4000! Default '<$1 -1', 


Stop class and keypointe This parameter allows stopping 
the Preprocessor after a given keypoint has been found. 
Notes howevers that collection will resune If another 
keypoint of STR class and keypoint is founds so that 
this start stop process is cyclical. 

Sxampla STP='4 4001! Default '-1 -1!'. 


This parameter aliows selection of only those keypeints 
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ID 


LIB 


LIBUN 


corresponding to a given task to be preprocessed. 
example TSK =5 Default -1> 
{all tasks). 


This is a teoggie to produce a preprocessed keypoint | 
file. 
Example PRE=N Default Y. 


This is a toggte to produce a compressed keyroint 
descriotor file. 
eExamole CDS=N Default Y- 


This ts a teggle to raolece the description into the PL. 
Examole ROS=¥ Default WN, 


This parameter specifies the type of Input data on the 
keypoints fille. Allowable types are HARD» SOFTs SIM. 
examojte FLT=SOFT Default HARD, 


This perameter specifies whether trace output Is to be 
ganer ated. 
Exampte TRO=¥ Default N. 


This parameter specifies whether a full keyeoint 
descriptor file is to bea generated. . 
Example DSC=¥ Default &. 


This parameter allows specification of the UN of the 

workspace conteining certain files. This allows @ 

single copy of these files toa exists simplifying 

procedures when they are updated. The files accessed 

using the ID parameter are KLE» PRE and DTF. 

Exampte I[D=KEYPERF Default user's 
own UN. 


Name of file where the object code for XKPPRE Is found. 
Ordinarily this parameter is obtained from the 'tooltibt 
parameter in the user's PROFILE. This parameter would 
ordinarily be used for testing a new version of the 
preprocessors or for usa of a specially modified version 
of the preprocessofre 

Examote LIB=MYLIB Default XULI3. 


liser number where file soacified by LIB above) resides. 
Ordinarily this parameter Is obtained from the 'tootact' 
parameter in the user's PROFILE. 

Examole LIBUN=UN1L2 Defauit KEYPERF, 
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Babe KP PRE sed PRO besenieie 


Some axamoles of how to Invoke the KPPRE procedure follow: 


SESeKPPRE DSF=DESCE This cali will pre-process file 
DATAFL and output the 


pre-processad keypoints into 
default file KPTDFL. 


SESeKPPRE DSF=D1 TRC=Y DSC=Y This call will do the above and 
will also generate the trace 
output and print the full 
keaypoint descriptor file. 


ScSeKPPRE TPF=ABCO02 DSFHDSF1 «2 . 

PRE=N TSK=4 This cscall willl process the 
keypoints collected on tape 
ABCO02. It will not generate 4 
full pre-processed keayooint file 
but will output a selective cne 
for keypoints belonging to task 
number 4 (TASKFL). 


SeSeKPPRE OTFSKPTS DSF=DL TRC=Y This call will pre-process the 
keypoints on disk file KPTS>» 
generating a full trace report 
and outputting the ore-processed 
keypoints on file KPTOFL. 


SeSeKPPRE OSF=DU TRO=Y MKP=1000 This will produce a processed 
kaypoint file called KPTOFL from 
the first 1000 keypoints of the 
input file DATAFL. It will also 
produce and print the trace file 
TRACFL containing the first 1000 
keypoints.e 


SESeKPPRE DOTF=AQLDPAR DSF=D1 This will produce and print the 
Pile KPTOFL containing the fist 
of the descriptions contained on 
the binary parsed file OLDPARF,. 
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825.22 KPPRE RUN PROCEDURES 


eKPPRE DSF=D1 MKP=16CO SKP=10000 os 
T3K =24 


This will create and run a betch 
job to pre-process the juoCe to 
11900th keypoints (approx.e)»s and 
eprint thelr descriotions. {The 
CoS is forced on anyway). The 
job will also create TASKFL 
which contains the pre-processed 
keypolnts of task number 24 
decimal. 
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9e9 PRIMARY DATA REDUCTION (KPRED) 


9.0 PRIMARY DATA_ REDUCTION (KPRED) 


The PMF Primary Bata Reduction program (KPRED) is designed to 
analyze keypoints collected during a single data collection and 
produce system level analysis reports. Later it will be exosnded 
to allow the data reduced to be broken out by time period for use 
by the Extended Reporting Factiity. 

The data reduction program was writtan to provide an earty tool 
to r@aducea keypoint data in order to give some statistics to 
support performance allocation and software development for the 
CYBER 189 and to form a base for lang term reporting softwares 


KPREO currantiy runs In 170 state under NOS versions 1 and 2. 
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Jel KPESD_ GENERAL DESCRIPTION 


The keypotnt data reduction program reduces keypoint date 
gathered from the ANOS/VE operating system. Keypoints must be 
processed by the kevpoint pre-processor previously described 
before they may be analyzed by KPRED. 


Thea KPRED vrogram is a treae-structureds modular program which 
reads the pre-processed keypoint fite created by the keyroint 
pra-processor and summarizes system level statistics from this 


Keypoint instructions are disseminated throughout the operating 
systems product sets and user codee Classes and KeyootInt numbers 
ar@ used to identify uniqueness of a keypoint. See the $15/180 
for further details of this structure. 
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9.2 2R0GRAM_DESCRIPIION 


The program has been written with the aim of satisfying two kind 
of customerst system develoopmeant and system performance. Thus» 
the program has been designed to have a common data gathering 
core with exoansible data statistic layers. 


Ge20l DATA GATHERING 


The common data gathering core is composed of 4 large 
multiw-rooted tree where leaves represent pertinent informatian 
for identi*?ied keypoints. 


In figure 21.1 tha structure of the tree which keeps keypoint 
information Is shown. 


Dynamic allocation is used to allocate space only for different 
keyooint numbers iets space is directiy proportional te the 
number of different keypoints and not the number of collected 
keyooints). 


The basic structure Is composed as follows? 
« & polnter (root) to each section: systems, oroduct and user. 


» An array which contains the description of 411 the 
different keypointse 


» 4n array which contains per each sub-section (or per every 
block of 50 keypoint numbers); a pointer to the first and 
last allocated keypoint block for the sub-section (if any). 


« A keypotnt block contains uniqueness information to 
Identify it3 counters and vectors used for the histograms 
(dynamically alloceted if requested); a pointer to the next 
block (4Ff any)3 a pointer to the first and tast data block 
(if any) which was gathered within the keypoint number. 


» A data block contains the data itseifs a count for the 
data» a pointer to the next block (CIF any)» and a pointer 
to the first and last data kaypoint block (if any) which 
would be the next following keypoint with no keypoint 
idantification.e 


« A&A data keypoint block contains the datas a count and «2 
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924 PRIMARY DATA REDUCTION (KPRED) 
Ge2Zel DATA GATHERING 


pointer to the next block (1? any). 


» Task Information Is kept In a tink tist reoresentation, 
Qniv existing tasks will use space. 


» Unit Udisk unit) Information is kept in a dink tist form 
where only existing units will have space allocated, 


» Tables for different summary Information are dumoed every 
specified time Intervet to the summary file. 
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9e2e2 DATA STATISTICS 


9eZe2 DATA STATISTICS 


Most of the statistics are computed by walking through the tree 
structure and collecting useful data to be used for computaticn. 
An independent spacial section has been defined in order to 
collect data te produce performance reports. This secticn Is 
axoansibie according to needs since keypoint numbers are 
hard-coded. 


The need to hard-code these keyooint numbers Is attributed to the 
fact that these reports need racognition of avents which Involve 
sequence of keypoints {er ai single keypoint) that have to be 
identified and trapped through one of these spacial orocesses in 
order to generate the reports. 
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e203 athe DUTPUTS 


9e203 STATISTIC OUTPUTS 


Several forms of output are generated according to selection of 
Input toggles CAs Bs Cs Ds Ex He Jo Ky Lo Neo Re Seo T and X). 
SUMMARY 
The summary statistics are gengrated exclusively by keeping 
accounting for each keypoints they Include? 

- Elapsed time, 

~ Total number of keypointse 

~ Kaeysoint frequency. 


- Summary per each sub-section: number of keypoint anc 
averagese 


- Total number of keypoints by class. 


This outout will always be orinted even with al} outputs 
disactivated. 


A= 2YSTEM_ KEY POINTS 


This means onty Keypoints of classas 0-5 are analyzed. 


Bt 2RODUCT_SET_KEYPOINTS 


Qnty keypoints of classes 6-16 are analyzed. 


&.2USS8_KEYPOLNTS 


niy keypoints of classes 11-14% are analyzed. 
By default ell kaypoints are idantified. 
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Fe tea cana actatatae stm tesa esineintaate iterate aati esa A ena ea ices Renan tienes ea oars Aiea tae ese aaaetie Rias nee Erase ton adnan ht asnatiinnathiens Rien atiaaee titan Nistteadh ae Span Rage Renee tinea ke nat usta aetiorn Ee anatien of aadhce tasockanndaanili austen atuaatnartione tes te sdtinteakcudne! 


Q-~_DATA_STATISTICS 
This information is gathered using the data Field within the 
keyooint oaumber and the data kaynooint. The printout will be for 
each section and for each differant keypoint If data exist. The 
outout will contain? 

- Kaypotnt nama and number. 

~ QOata content and data keypnint content. 


~ Counts and percentages. 


Following is an example of the output: 


PURGE BUFFER 4900 SVA COUNT 2%=COUNT 
4FO 3 10025 OATA-KPT COUNT %-COUNT 


2 
1008 
2008 
3608 


12250 
12.50 
12.50 
12.59 


pd fad faa fant 


Kot. name Content % of occurrences % within thea 
data field within the sub=- kpte NOe 
section 


Kote noe Cccurrences Content of 


Name of data kpt,. 
the data fieid Occurrences 
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Informative errors are printed to warn the user that something 
did not foliow all rulas governing kaypoint sequences. Following 
is an example of an error message: 

3277001 010d. Procedure entry/exit not in sequences 
Kpt. time arror Oe error dascription 

stamp 


The time stamp Is printed because It has uniqueness among al} 
other *lelds thus identifying tha keypoint without ambiguity 
since no two time stamps are identical. 


A summary teble showing how many errors of which type Is also 
printed at the end of the run. 


debe Ne _X = JLSTOGR AMS 


For gach identified keypoint three histograms are generated: 


Keyopoint frequencye 


- Time to next orocedure call tor next occurrence of same 
kevooint). | | 


- Time between entry/exit of procedures (where entry and exit 
kot, ere spacified),. 


L =- Histoaqram for Last Call (last occurrence). 


= 


- Histogram for Next Keypoint (fraquency). 

X ~- Histogram for entry/exit of srocedures, 
Thus H Includes all histograms. However Ls N and X affect onty 
the corresponding histograms. 


A sampiea histogram outout Is shown In the Quteut Reports section. 
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Fe2@e3 STATISTIC OUTPUTS 


dy K_ = TASK _ STATISTICS 
For each task in the system the following data is produced. 
- User time In microseconds and as a percentage of the total 
task tima,. 


-~ Monitor time in microseconds and as a percantage of the 
total task timee 


- Total times percent against tetal rune 


~ Chronological order of appearance for all keypoints with 
counts and percentages; 


~ Total and parcentages for the antire run} 


~ Segmant and page feults informatione 


The K toggle is used to print a kaypoint summary by task. 

The NOS/VE monitor exit keypoint (number 4901) Is used to keep 
task accounting. 

Following is an example of the output: 

dIa2agle 


Task noe User Time 7% UM MTR Time % MM TOT. Time 2% 
Time 


21753 43444 21028 32086 42781 37220 
| 


Chronological ordar if selected (K toggle) 


Segment and Paga Faults information 
3 
a 


TOTAL 50073 43.99 63997 56010 114075 = 100-6¢ 
DIFFER 36073 G.00 63295 6017 114670 6.00 
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Je2e3 STATISTIC OUTPUTS 


K_Iogale 


KEYPOINT 
COUNT = % TASK = % TOTAL 


pamtstartustop Ket 
omKtexecute 
allocate space in heap 
$ 
: 
TOTAL 601 99.83 


0047 0.17 
0.94 0233 
4.25 1650 


fp FO pt 


The line named "DIFFER" Is a checkpoint sum which is able to 
verlfy Ff the accounting was kept accurately. The "1" showed 
under the keypoint count is caused by a faulty keypolnt which 
gave an error conditions thus it was not recorded, 
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9.2.3 STATISTIC OUTPUTS 


Ru-.2aeocts 


This output should give the performance evaluation report. 
Howeavers since most of the keyooints area not available to produce 
such a Full reports only a small subset is generated. 


~m CPU Usage (per each CPU)? 


M4 time with percentages 
UM time with percentages 
Total CPU times 

HW/SW comparison timas. 


o* #6 #¢ ® 


Keypoint #4901 is used to keep the CPU time accountings 


~ Memory Manager 


» Total page faults/sec,. 

» Page faults/sece with I/D. 

» Page faults/sec. without 179s broken down into: 
e new pagesys 
* reclaimeds 
e otherss 


Keyooint #1104 is used to keep accounting for the page faults. 


~ Peripheral Device Usage 


» noe Of I/D requests, 

e avge byte transfar 

e type of request (inputs output)» 
» 8¥%- 70 queue length. 


No keypoints are available at the time of this update for I/0 
statistles. 
- Summary Histograms 

° overall keypoint frequency» 


° overall time to next procedure calls 
e overall time between entry/exit of procedures, 
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Jele3 STATISTIC OUTPUTS 


3.7 Sumnacy by sub-section 
For each sub-section within eacn saction (systems products user)>s 
a summary report is produced! 


Keyooint name and keypoint number 

Counts percentages average within the sub-section. 
Average frequencys next calls and entry/exit. 
Total by sections sverages and maximums. 


*¢* @ @ @ 


Following is an example of this outopute 


LG USAGE BY FUNCTION 


Kot=-name Kot Count 2Count %ount Avg.sTime Max ese AvgeTime Max 
NOe Module Total Next Call eee ENTSExt 


LSKSLOG_LASCII 320 4 190.00 0.66 7165.90 91856 20i2e50 Z11it 
4 e556 8 47165.00 91856 2012.50 2110 


Sub-sectioan 
Hane 


TeotIrace Qume 


For every keypoints one tine of outout is produced using the 
Following format: 


23%8 12 233 26H PFTI 4 1222 M MM 3 OD Make page table entry 


time data format class# kpt# subsect. Kaypoint descriotion 
(usec) Field (H=hex.) MM=memory manager 

delta . data CPU) Mode task noe 

time description M=emonitor Class Type (D=debugq) 
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963 DESCRIPTION OF _EILES_USED 
GeBei INPUT FILES 


INPUT? This file contains the program input parameters (toggles). 


FKPDS: This fide contains the deseription of ail the keypcoints in 
the data file. It is the first record of the date file KPTDFL 
which Is an outout file from the pre-processor program KPPRE. 


FKPDT: This fide contains the prea-processed keypoints. It is the 
second racord of the output file KPTDFL generated by the 
ePre-procesor orogram KPPRE. 


FK PDO: This file contains information for data statistics 
recordings This reduces the runtime CM usage considerably when 
used correctiy. The fite Format is: , 

Class Kaypoint D (for delete) 


this mean the data will not be recorded for that specific 
Keaypoint. 


9e30e2 DQITPUT FILES 

VITPUT: This file contains all the selected outouts!: traces 
histograms» summary reports» data statisticss etce 

FOEBG: This fille contains a small amount of dabugging informetion 


which keeps tracks of the logic flow of the program, 


FKPS™M: This fille contains summary Information per selected time 
interval for the I/Os Systems Memory Mares Task Mores atece This 
file will be used as input by the summary reports generator. 
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9e9 PRIMARY DATA REDUCTION (KPRED) 


904 QUIPUL_ REPORTS 


Fete 


TIME 
OV MICROSEC 


DE 


KEYPOINT TRACE 


LTA 
TIME 


DATA 


oS 


Oo 
Oooo vw»ooovesaoooov GC agwooos 


eee Ree es SOs hoe ys Ee TS eS Der Ee orcs 


dll aed seal 


FID .9RD 


DATA 
NAME 


ee 
UF 
w 


G3 63 GPS te TY bo 6 GPO oo I te fo td fe Po oo) A Go fo in 


STATUS 
D3G_MODE 
STATUS 
STATUS 
STATUS 
STATUS 
STATUS 


MCR 


FI0.O0RD 
FIO.GRD 
STATUS 

STATUS 

STATUS 

FID.ORD 
FID.ORD 
FID.ORD 
OP 

FID .ORD 
STATUS 

STATUS 

STATUS 

STATUS 

STATUS 


mS 


U 


nel 
ee 
> 


0 
G 
0 
rs 
5 
0 
0 
0 
a 


Oo ooese oGceoeoco cee osooes Seogooo moo eo & 


T DESCRIPTION 


ae 3d SC PT OO AE OO FO Th 


mT PIT 


a OX OK TTI TTT << NOX PT 


EXIT 


#* UNDEFINED KEYPQINT #* 
CLPSGET_VALUE 
CLPSGET_VALUF 
CLPSPOP_BLOCK_STACK 
CLPSPOP_BLOCK_STACK 


ENTER J0O8 TRAP HANDLER 


PMPSESTABLISH_ CONDITION HANDLER 
PMPSESTAPLISH CONDITION_HANDLER 
PMPSTASK_DEBUG_MONE_ON 

PMP STASK_DERBUG_MODE_ON 

PMP SESTABLISH_ CONDI TION_HANODL EQ 
PNPSESTABLISH_CONDITION_4ANDLEQ 
PMP SESTABLISH_CONDITION_4ANDLER 
PMPSESTABLISH_CONDITION_HANDLER 


PMPSESTABLISH_CONDITION_4ANOLER 
PMPSESTABLISH_CONDITION_HANDLER 
POMP SESTABLISH_CONDITION_HANDLER 
PMPSESTABLISH_CONDITION_YANODLER 
PMP SESTABLISH_CONDITION_HANOLED? 
PMP SESTABLISH_CONODITION_4ANDLEP 
JO8 TRAP HANDLER 
CLPSPROCESS_COMMAND 

3079 .117. 
CLPSGET_DATA_LINE 
AMPSGET_NEXT_KEY 
BAPSSYS_BLK_VARTASLE_@EC_"A2? 
BAP SGET_NEXT 
BAPSGET_NEXT 
BAPSSYS_BLK_VARIABLE_REC_EAP 
AMP SGET_NEXT_KEY 
AMPSFETCH_ACCESS_INFORMATION 
BAPSSYS_BLK_VARIABLE_REC_fAD 
ANPSACCESS_METHON 
BAP SCONTROL 
BAPSFETCH_ACCESS_INFO 
BAPSFETCH_ACCESS_INFQ 
BAPSCONTREL STATUS = 0 
AMPSACCESS_ METHOD 
BAPSSYS_BLK_VARIABLE_REC_FAD 
AMPSFETCH_ACCESS_INERMATION 
CLPSGET_DATA_LINE 


=> NORMAL 
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9.0 PRIMARY DATA REDUCTION (KPRED) 
Ge%e2 ERROR SUMMARY 


9e4e2 ERROR SUMMARY 


ERR=NO ERROR MESSAGE COUNT 
190 KEYPOINT MATCH NOT FOUND 26 


10% CPU STATE OUT OF SEQUENCE 4 
113 PROCEDURE EXIT NCT IN SEQUENCE 9 
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9e4e3 KEYPOINT SUMMARY 


904.3 KEYPOINT SUMMARY 


PMF RUN 
CONTROL-TOSGLES CLNT KUN-NO. 99 START=TIMNE 6) STOP={TIME 24212533 ELAPSEN-TIME 


TOTAL -KPT 135334 KPT=-FREQUENCY 005.65 USEC HW-BUPFF<OVFL 1 SWB UFE MWD VEL 


CLASS COUNT %—THT 


is) 0.04 
6632 49200 
5646 49.11 

1 9.01 

132 0.98 
114 02384 
3 0.02 


Aw 0p 4 Wo PRO pS 


13534 100.90 


COUNT PERCENT 


572 4.23 
931 5.88 
2007 14. 83 
1062 -7..85 
120 0.385 

8 «Gn OF 
514 3,86 
174 1.29 
C 292 2216 
PM (1600) 846 6025 
PM (1650) 5 0.04 
ST (2889) 8 et 
JM (1900) 538 3.72 
AV (2169) 2 Gell 
19 (2209) 284 2010 
RM (2250) 34 ue2s 
MT (4009) 3893 43,54 


FO { 250) 10 0.07 
C ( 750) 236 1.74 


13508 99.61 
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9e40% SYSTEM SUMMARY 


904e%4 SYSTEM SUMMARY 


MT CPU USAGE 


cey 0 


CPU-TIME 54212533 100.00% 

TOLE G 0.00% 
TOTAL 54212533 

MTR=MODE 50707911 93.54% 

USR=MODE 2615508 4.822% 

170-MIDE £89114 1.64% 


QCCURRENTES FREQUENCY AVG.DURATION 


MONTTOR MONDE 1289 42957232 39333 .95 
USER MOOc 1290 42925422 2027053 
179 MODE 1275 42519.63 697.34 
MONITOR MODE TRAPS 357 151855.83 497.33 
USER MODE TRAPS 24% 2258855454 76765 .42 
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903 PRIMARY DATA REDUCTION (KPRED) 
90405 PAGING SUMMARY 


90403 PAGING SUMMARY 


MM PAG: 


avs USER 
PER SEC. COUNT PER SEC. 


PAGE FAULTS 3.87 210 0.00 
PAGE FAULTS (1/9) 1.75 95 0.00 
PAGE FAULTS (NO T/9) 2012 115 C000 
RECLAIMED 004 
NeW 1.55 
PT FULL re 
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Gee TASK MANAGER SUMMARY 


90406 TASK FANAGER SUMMARY 


T™™ TASK MANAGER 


cpu 0 


TASK SWITCHES 1290 
TASK SWITCHES TO SAME TASK 1287 
TASK SWITCHES FREQUENCY 42025.22 


) 
ae 


i 
f 
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9eo4e7 COMMON T/0 SUMMARY 


JMMON I/O SUMMARY 


10 PERTPHERAL OEVICE USAGE 


To be supplied. 
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90403 HEST ee EXAMPLE 


904.8 HISTOGRAM EXAMPLE 


TIME BETWEEN ENTRY AND EXITS (MICROSEC) 
Y-STEP 37) @ 379 740 411¢ 1480 1850 
¥ Xe GRP vy ae 4 me se ene seem seam eee san ee mam y aieertiomtamiantnadkonstemenm tend te 20 eee ae ee ee see dp ee ee eae ee ae oe se ee hp ae a ee oe en sen ae ee ee Ap 


OOtUPHeRroe 
pag 
# 


0.30 
10 I* 

130 [#*e es 

25 [ea 

QR [eee 

50 [*k* 

63 [** 

73 [** 

83 Tee 
100 [*** 
125 [RRR RR RE EER AE REE RE KEE RE EERE EE EE EEE SE EEE EERE 
250 [ERR ARE AEE RRR AEEREAEKER 

3 De ke kx 

EOD [ERE KRERE KER 

625 [*** ¥% TOTAL Y-AYTIS 

QO [*¥** ** MAX PEAK Y-AX TS 

875 [eke REE 
1000 [kK *RE EES TOTAL XmAXTS 2 
L250 [RRR RA EERE EEK EER ER MAX PEAK Y=AXTS 
25OQ adores 
3750 [***x* VARTANCE 9,39295294 
ECOG I** STAND DEVIATION 


Oey Up wsee SS 


15 0.01 


po 
xy ig CR 
pet NS 


23 0.46 


7500 1* SKEWNESS 4.47837219 
8759 I* RELSSKEWNESS 


12560 T** | MEDIAN BIN 


37500 I*® MINIMUM 
50000 I** MAXIMUM 


75000 I* AVERAGE 
7509 I* 


nv 
© 
COOKF OOH SO GOOMN WHE UBN ROE NNN NE Be BD OM OOO OO Um 
w 
“~d 
qt 


i353 

~*) 

iad 

o 
oe 8H 

G 
o 


25000000 I 
37500C00 I* 


wi 

2s 
oo 
BO 


tad 
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9e4e9 TASK STATISTICS =X AMPLE 


92429 TASK STATISTICS EXAMPLE 


TASK=-NO USER-TIME MODE MTR=~TIME MODE TOT-Ti 
73 81475 2032 1381875 2273 14633 


4091 EXIT 186 MONITOR MODE 
129 AMPSPUT_NEXT 
148 VALIDATE_CALLER_PRIVILEGE 
1631 PMPS$GET_TASK_ID 
178 BAPSNULL_DEVICE 
1617 PMP SESTABLISH_CONDITION_HANDLER 
263 CLPSSCAN_TOKEN 
280 CLPSPROCESS_COMMAND 
293 CLP SFIND_PATH_DESC_VIA_LEN 
284 CLPSCONVERT_STRING_TO_FILE 
4602 ENTER NOS 170 
1918 SWITCH TASK 
160 BA? $FETCH_ART_TABLE_POINTER 
265 CLPSCONVERT_STRING_TO_NAME 
117 AMP SGET_FILE_ATTRIBUTES 
167 BAPSGET_FILZ_ATTR 
4093 ENTER MONITOR TRAP HANDLER 
2201 INPSPROCESS_IO_COMPLETIONS 
44% DMPSTRANSFER_UNIT_WRITTEN 
497 DMP $FETCH_EQI 
238 CLPSPUSH_BLOCK_STACK 
1590 PMP SEXECUTE_TASK 
: 3 
2531 CLPSSCAN_PARAMETER_LIST 


NNN NNN BPS PS po he Po PO RS I DO DD DO tg I Ge 


iv 


SEGMENT AVATL AV.MOD VALID NO PG.WITH PAG 
NUMBER QUEUE QUEUE IN=PT MEMORY ID-ACTV ON-DIS 


oe 


nm 
7 
CoOrFrFOOG OOO ao 
OFMOOKM Fe Ur FO 
Se aaeoa ooo oo 


Co SOC Te Coo of6ce 
Seen gaoae 


~~ 
a 
mo 
os 


0 
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FULL 
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904010 DATA STATISTICS EXAMPLE 


eEPAGE TABLE TS FULL S%* 1 1101 PTT COUNT %=COUNT 


843 
845 
ERR 


16.67 
16.47 
16.67 


E47 


PAGE TABLE FULL PROCESSIR 21146 PTI COUNT %-<COUNT 


é 160.06 
PAGE TABLE FULL PROCESSOR 3.1146 PTI — COUNT %-COUNT 


3 83.33 
1 16067 


hn 
i 


6 160.00 

DELETE SEGMENT BY SEGMENT NUMBER 2 1105 COUNT %=CNUNT 
1 2 100.06 

DELETE SEGMENT AY SEGMENT NUMBER 3.1105 COUNT %=COUNT 
1 2 100,00 

FREE PAGES 2 1104 COUNT %-COUNT 


C 12 Z 100.00 
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Jed PRIMARY DATA REDUCTION (KPRED) 
Ge4ell SECTION SUMMARY 


Ge4ell SECTION SUMMARY 


MM USAGE BY FUNCTIONS 


KPT-NO COUNT Z—COQUNT %=COUNT 
MODULE TOTAL 


KPT=NAME AVG=TIME = MAX 
NEXT-CALL 
MILLISEC 
PAGE FAULT PROCESSOR 
1106 = 420 81e71 = 3 10 

SET/GET SEGMENT LENGTH MONITOR REQUEST 

1142 32 60230424 
#¥PAGE TABLE IS FULL##4 

1101 6 el? 6204 


29459404 54942 
19596.69 51958 


8232283 18405 
PERIODIC CALL 

1136 16 3110412 
PAGE TASLE FULL PROCESSOR 

1146 az 
DELETE SEGMENT BY SEGMENT NUMBER 

1165 24 4.67 6.18 


32370.00 49396 
51649.5€ 53258 
FREE PAGES 


1104 4 0.78 6.03 51953.00 51959 


2973582 34042 
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AVG-TIME 
NEXT=KPT 
MICROSEC 


326056 
146.69 
248,83 

55019 
984.17 


393.87 


MAX 


AYG-TT™M 
ENTIEX 
MICROSE 
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900 PRIMARY 


9e4el2 INTERVAL SUMM 


DATA RE =DUCTION (KP RED) 


ARY FILE 


AAS A A AN SS aN bl AONDG. AAR ON SR AA SO ia PI Saal Ne AO A SEN ON UN =A A ST ND NN OD TD AUD NED TN AOD TUNE NA SEND WORD A WED AUN SEND SNND ANE ANS <OOUh SE SD SE ED A ee ee SOD ane ee ee ee te ee 


Je4e12 INTERVAL SUMMARY FILE 


4690 


4000 
1100 
1900 


10000 
9812 6 


19402 9 


29238 


29238 3 


29238 
39212 
39212 
39212 
4A674 
48674 
&B674 


WoOooagoese 


233 


246 
257 

19 
257 
241 

26 
241 
122 

50 
ié2 


9128 


rh 
Wi 
KS 


510 259 173 #4¢4K4e9G2= 099530582 7H 
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| eed 
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9.9 PRIMARY DATA REDUCTION (KPRED) 
Go5 OPERATIONAL PROCEDURES 


9.5 QPERALIONAL PROCEDURES 


GeSe0l 


INSTALLATION 


To install this program three files are needed? PMFPL, XULIB 
PMFPLI8. To compile and save the binary of the data reduction 
program type: 


SES ePMFINST KPRED 


9e5e2 DATA REDUCTION OPTIONS 


To run the data reducticrn program: 


XKPRED sinputsoutputs fdebgs Fkods»sfkpdfsfkosmsfFrodde 


Inout? TGL RNO SKP SKC MER MOT INT SCT 


a@heres 


TGL3 
RNOs 
MKP? 


SKP3 


SKo% 


MOT 3 


program control toggtes (AICDEHIKL NEST X) » 
run numbers 
maximum number of keypoints te process,» 


number of keypoints to skip at the beginning of 
keavooint files 


start keypoint class» 
maximum number of data fines to records 
maximum number of errors to printeds 


summaries interval in millisaces 


oniy keypoints with this section number will be printed 


the traces 


input must follow these rules and/or restrictions: 


and 


the 


in 


all the Input parameters are optional. Howevers IF the ith 
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9oG PRIMARY DATA REDUCTION (KPRED) 
90502 DATA REDUCTION OPTIONS 


Parameter Is specifieds all his oredecessors must also be 
presant» 


- any number of blanks can preceed or follow each of the 
tokens of the inputs at least one blank has to appear =inr 
‘between each tokans 


~ if the Input file is empty the followina defaults are 
assumed 


@a!1 outouts are printed (TGL = {})> 

the run number is equal to zero (RNOD = G)>» 

ali keypocints are processed (MKP = ~1)>» 

no keypoints are skipoed at the beginning of the dates 
fite (SKP = @)>» . 

the start keypoint ctass is 15 (SKC = 15)» 

up to 1000 errors will be printed (MER = 10095)» 

up to 160 deta fields will be recorded (MDT = 100)» 
no summary willl be processed (INT = —1)>» 

the trace will eprint all keypoltlnts belonging to any 
section (SCT = 9999). 


« © «6 « 


* « # 8 « 


= TGL Coptionai)s the program control toggles consist of a 
string of characters (4 through Z)» the string mey be 
enptys 


- BRNO {optional)d),s the run number is any positive integer oof 
six digits or less. 


- MKP {ontionald)s the maximum number of keypoints to process 
is an Integer which follows these rules? 


» YU = no kaypotiInts will be processed» onty the PMF 
counters statistics will be printed (If PME counters 
are present in the data file)» 

e nN = Only up to n keypoints will be processeds 

e “2 = Orocess 811 kavypointss 


- SKP Coptional)»s, the number of keaypoints to skip is an 
Integer following these rules: 


do not skip keyroointss 

skip up ton keypoints at the beginning of the data 
File» 

skio all keypointss thus printing onity the PMF 


» 9 
n 


| 


eo =} 
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eounters statistics (1? PMF counters are present in 
the data file). 


~ SKC {optional)ds the start keypoint class is an integer 
hatween O and 15. 


start with any class 


e G 
n start reducing with the first kept. of class n. 


io 


MER Coptional)»s this parameter allows the user to limit the 
number of error messages to be printede The error summary 
talbe Is always actives regardiess of the valua of MER or 
the toagie tet: 


it 


has the same effect as toggtie &'s no error 
MESSAQES» 
« © = Prints up to n @rror massages» 

= all error messages are printed. 


~ MOT Coptional)s this parametar limits the number of deta to 
be recorded. This reduces the runtime memory usage. 


e 0 = do not save any datas thus the same effect as toagqie 
Ht, 

Saye up to n data items for each keypoints 

save all data, 


« 
“ 
ii ou 


~ INT (Coptional)»s this paraneter allow the user to save on a 
file (FKPSM) summary information at specified interval 
(nililisece). This File will be used by the summary reports 
generator. 


dump summaries every n mililisecondss 
do not dump summaries. 


| 


eown 


~_ SCT Coptional)s the section number Is an integer (with up 
to Four digits) which may be equal to any of the section 
numbers defined in the keypoint dascription filiee 


e If no trace Is salecteds this parameter is fanored. 


° If specified with a value of 9999 all sections will 
be printed. 
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925-3 PROGRAM CONTROL PARAMETERS 


The data reduction program has been provided with several program 
control toggles. These toggies will deactivate parts of the 
Qutout If selected. ; 


By default all different outputs are orinted; if any one todgle 


is set» it deselaects the corresponding eutout. The following is 
a brief description of these toaggias? 


As3eC03 deselect processing of system» product sets or user 
kKaypoints respectively. 


a: desaliects the dete outout. This sonsists of statistics for 
the data values (if any) gathered by keyooint number, 


et deselects non fatel error messagese 


3 dasalects all histograms outout (thus It implies L» N and X 
also). / 


Ji dasaltlects task statistics. 
Ks daselects task kaypoint description. 


8 deselects (Last) histograms for frequency of calls for 2 
specific keypolint. 


Nt deselects (Next) histogram for frequency of a specific 
keynoint. , 


Rt deselects the report Information which Includes: CPU usages 
page fault statisticss peripherais device usage and summary 
histograms for each histogram type, 


$3 deselects summary output. This is a Summary of every 
section of the operating system. 


T: desafects the trace dump for every keypointe 


X3 deselects (antry/exit) histograms for average entry/exit 
times of selected procedures. 


If ali toagtes are selected» only one nage of output will be 
ganerated. This consists of a very concise summary including? 
alapsed times total number of keypointss overall frequency» run 
numbers kevyooint counts for every sections etce 
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95504 KORED RUN PROCEDURES 


An SES procedure is provided to run KPRED, The following 
describes the proc in details, 


Any of the parameters dafined in the SES module JOBPARM may be 
used. These Include JOBRTL»s JOBFL» JOBCN» JOBPR», JOBUN» JCBPW» 
JOBEMLY» JQBCNs JOBPN»s LOCAL» BATCHN» BATCH» DEFER» NODAYFs 
DAYFILEs AND DOF, (See SES Procadure Writer's Guides Apoendix A) 


TPF If? the preprocessad data is on tapes TPF is used to 
specify the VSN(s) of the tape({s) on which the data Is 
found. If the VSN(s) have teading Os the VSN must be 
enclosed in single quote marks. If the data Is spreed 
across more then one reels the tist of VSNs must he 
enclosed in parenthesis. Up to 10 reels of tape may be 
specified. Tapes must be labeled. 

Examole TPF=('000123's123456) Default none. 


OTF If the preprocessed data is on mass storages DTF 
specifies the file name In which the data is stored. I[f 
OTF Is not founds KPRED runs KPPRE to create one. The 
file may be focals direct access» or even indirect 
access afthough the tlast alternative is usually 
impractical. 
Exampie OTF=DATAFL Default OATAFL. 


DSF This parameter specifies the file where the keypolnt 
descriotors are found. This is an output from KPPRE. 
Example DSF=DESCFEL Default none>s 
required parameter. 


DODF This parameter allows specification of an input file for 
reducing the processing during data statistics analysis. 
The file format is: 
Ciass Keypoint 0 (for delete) 
this means the data fiatd will not be recorded for that 
keypoint. 
Exampte DDF=DELDT Defauit DATOEF. 


RDF This psrameter specifies the Ifn of the KPRED output 
file, . 
Examole RDF=QUT Default OKPRED. 


NGF This paremeter specifies the {fn of the KPRED debug 


File, 
Examole OGF=EDEBUG Default DBGF, 
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SMF This parameter allows specification of the KPRED summary 
Example SMF=eSUMMARY Default SMYF. 


TGL This parameter aliows setting of various progran 
toggles. The permitted toggles are ABCDEJKLNRSTX,. 
Examole TGiL=8C xX Default CLNT. 


TIT This parameter allows specifying a title of up to 40 
: characterse 
Examole TIT="PME QUN FOR EMU! Default PMF RUN. 


RNO This parameter aliows specifying a run number (mex cf 6 
Example RNO=1 Default 99. 


a} 
cy 


This parameter allows specifying the starting keypoint 
class for processings 
Example SKC=13 Default 0. 


MER This parameter spacifies the number of errors to print, 
tf the number of errors exceeds this number processing 
eontinues but the remaining errors are not printed, 
Example MER=300 Default 1000 


MOT This parameter specifies the maximum number of data 
values to sava per keyooint. 
Example MOT #25. Default 100. 


INT This parameter allows the summary data to be dumped at 
some specified Interval {in miliiseconds). Howevers the 
follow on program for formatting the output has not been 
written yat. Therefores do not use this parameter. 
éxamole INT=100 Default —1> 

(ignore Interval). 


wi 
rae 
oom 


This parameter allows specification of which section 
Number to print. This parameter works In concordance 
with the program toggle T (trace). This would be used 
if onty one section of keypoints (iees L50G-1550) Is of 
interest (if the number is not the start of a sections 
modulo 50 division will be done such that for instance 
L525 would print the keypoints 1500-1549). 

Exampie SCT=1500 Defauit 9999» 

{all sections). 
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SKP 


MKP 


TD 


Lia 


LIBUN 


Mumber of keypoints to skip at the beginning of the rar 
keypoint file (CTF or TPF). 
Exampje SKP=1000 Default %. 


4aximum number of keypoints to process from DTF. 
Example MKP=2000 Default 9999999¢ 


This parameter allows specification of the UN of ~ the 

workspace containing certain files. This allows -# 

single copy of these files to exists simplifying 

procedures «hen they are updated. The files accessed 

using the ID parameter are DDFs DTF and BSF. 

Example ID=KEYPERF Default user's 
own UN.» 


Name of File where the object code for XKPRED Is found. 
Ordinarily this parameter is obtained from the 'toolttibt 
parameter in the user's PROFILE. This psrameter would 
ordinarliiy ba used for testing a new version of the 
preprocessors or for usa of a specnelly modified versicn 
of the preprocessor. 

eExampie LIB=MYLIB |. Default XULIB, 


User number whera file spacified by LIB above) resides. 
Jrdinarily this parameter fs obtained from the 'toolact! 
parameter in the user'ts PROFILE. 

Example LIGUN=UN12 Default KEYPERF. 


Some examples of how to invoke the KPPRE procedure follow: 


SeSeKPRED DOSF=DSF1 OTF=KPTDOFL This call wlll reduce all the 


ESeKPRE 


kaypoints on file KPTDFL and the 
output will be found on file 
DKPRED. The toggles setting 
are? no user kpt.»s no trace and 
entry/exit histogram only. 


) TPF=A3CO01 DSFEDSF1 es 


PNO2131282 MKP=500G . This call reduces the kepypoints 


which are on tape ABCOOls, will 
have a run number such as the 
date 135 Dec 1982» and wil! 
raducea only the Fitst 5000 

keypoints. . 


Control Data Private 


Performance Rerorting Facility ERS 
2% Feb 84 


10.0 KEYPOINT CALL ANALYSIS TOOL 


10.0 KEYPOINT CALL _ ANALYSIS TOOL 


The Call Analysis progrem is a method of abtaining statistice!l 
data about orogram dynamics from the keypoints collected using 
the Performance Monitoring Facility (PMF). The data is used tos 
reconstruct the calls made by the various procedures which have 
had keypoints inserted et their entry and exit points. The 
analysis will oniy work if the programs being analyzed are 
aritten In a structured manner such as is obtained from languages 
fikea CY@®TL or PASCAL. It will also work for any other programs 
which use the discipline of performing in a block type of 
structure. Branching sround entrys or exits with keyooints wil! 
substantially reduce the accuracy of the analysis. The Call 
Analysis orogram requires that at a minimum all task switching by 
the operating system must be keypointed, 
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sl DESCRIPTION GE EILES_USED 


There are five files associated with a run of CALLAN. Three of 
these are input filess the other two are output files. 


PARMFL is the file containing the parameters. In the current 
version of CALLAN there Is only one parameter which Is 
recognized, This parameter allows the run to be terminated 
without running until an end of file Is encountered on the 
K@ypotint file. The format of this parameter Is! 


RECOROS = nannann 


MRECORDS™ should be teft justified. The "=" must have a space on 
either side. annnnn is a decimal number indicating how many 
keypoints to oerocass.s CALL&N does not begin counting records 
until after the first entrance to a task is encountered, Thus» 
the keypoint file will read from 1 to several hundred keypooints 
more than the amount indicated by this parameter. CALLAN willl 
stop reading the keypoint file when an end of File Is ancountered 
or the count is exceededs whichever comes first. The running 
time goes up very rapidiy as the size of thea tree increases. The 
first keyeootnts on the file are processed In about 1 msec per 
record on an $2 whereas after 225939 records have been reads the 
average time Is around 35 msecs per keypoint. The file on which 
these measurements were taken contained some irreguliarittes which 
may account for this tremendous Increase In running time. The 
algorithm used should not be that sensitive to file sizes and a 
proper keypoint File may run much fastere This willl be 
determined when more keyooltInt Files become available. The memory 
reaulrements also Increase with File size. At the beginning the 
analyzer will run in about 60K. 8y the end of the file used in 
the measurementss with 333000 keypointss the memory requirements 
increased to 274K. For files with thea irregularities in the file 
used» this memory increase Is not surprising. In a proper file 
the memory requirements should be considerably less. 


DESCFL is the fite containing the keypoint descriptors. It Is 
the first fogical record of the output file of the keypoint 
pre-processore Three categories of keypotnts are recognizeds the 
operating systen keypoints from classes Z and 3» the product set 
keypoints from classas 8 and 9» and the user keypoints from 
classes 12 and 13. Within each of these categories» if a 
descriotor appears more than onces the descriptor for the test 
entry keypoint on the file is used. Thusys if there is a 
descriptor for a keypoint in both entry and exit classess the Z» 
8s or 12 descriptors will be usede The same keypoint number may 
be used in each of the 3 categorias. That iss there may be three 
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keypoint 75060ss for instances ona in the operating systems one in 
the product set» and one in the user keypoints. 


DATAFL contsins the keypoints which are to be analyzed. It is 
obtained from the second logical racord of the output Pile from 
the keypoint pre-processor. Only keypoints of classes 2939825912 
and 13 are used by CALLAN. Any other keypoints are ignored. Ai} 
keypolIntss up to the point of entry to the first task on the 
Kkaypoint file are also ignored. 


REPORT is the file containing the summarized data for the 
keypoint analysis. The first line Indicates the amount of time 
that was monitored. The statistical data is broken down into 
reports for each task found on the kaypoint File. The first tine 
of the task Is a report on the task Itself. It Is currently af! 
Ss but wlll aventually be used to hold task ralated information. 
Followins this is the report on the keypoints in ascending order. 


TAPS1L is a file containing supplementary informatlon about the 
keypoint *Pite. It is primarily a debugging files but It may also 
be used to deduce information about the keypoiInt file. This file 
is written during the analysis phasa» so that if the program 
aborts» the data on this file can lead to an approximate point 
where the difficulty ties, 
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10.2 QULPUL BEPO2TS 


The call analyzer separates the kaypoints such that statistics 
are kent for each task. Each task Is reported by the number 
Found in the 4001 keypoint. This kaypoint gives the task id of 
the task being dispatched on exit from NOS/VE monitor. 


Tne data vpresented in the report is the summary of orocedure 
eneracteristies in a dynamic environment, During the analysis 
phase of the Call Analyzers each keypoint is constructed in its 
rightful place in the hierarchy of a treas with ali keypoints 
having a common parent being tinked together In one branch. 
Parant in the sensa used here is the term for the situation where 
there has heen an entry keypoint executeds but the subsequent 
exit has not yet been executed. If an axit keypoint were to be 
lost» the keypoint would remain as an ancestor of all tha rest of 
the xkeypoints in tha taske <A s@parate tree is maintainec for 
each task on the keypoint file. The same keypoint may occur at 
many levels of the treee It may appear as a chliid of Itself. 
This would be the case of recursive calis. It elso occurs in 
some cases where the execution is forced by an interrupt or trap 
machanism. It could aiso occur as the result of a tost keypoint. 


In any cases the date for all occurrencas of a given keypoint 
within a task are gathered into one set of summary statistics. 
The data regarding 2ach of the kaypoint's immediate children are 
also gathered. In the case of a childs only the statistics which 
ralate ot the particular parent are rsported. For instances if 
keyopoint 750 is calted 10 times by 3 different parentss the times 
and number of times called es a child is reported In the context 
of its realationship with its immediate parent. But when the 
statistics of 750 as a parent are revorteds all instances of its 
usage are revorted, 


It wll} be instructive to describe thea method by which the data 
is analyzed. To reconstruct the environment In which the 
procedures axisted when the keypoints were generateds a stack is 
maintained for each taske When an entry keyooint Is encountered» 
the keyooint is antered on the stack. Teo allow the same keypoint 
number to be used for operating system» product sets» and user 
kKaypointss the keypoint is concatenated with 1s 2 or 3 
respectivaly. When an exit keypoint is encountered it should he 
the same as the bottom keypoint on the stack for property 
structured procedurase At the time of entry on the stack 
necessary data Is stored In a orocedure record. When tha exit Is 
encountereads tha CP time and real time are determined for the 
procedure is calculated and stored in the procedure record, If 
an improver exit is eccountereds due to Improper keypooint 
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disctpline or because of lost keypolntss the stack Is searched 
backward to find a matching entry soneawhere in the stack. If an 
entry is founds the kaypoints between the current poesitien and 
the match are discarded. This explains why the two counts on the 
report are sometimes different. "Count" Is incremented eech time 
an entry keypoint Is entered on the stack. "Valid count" Is onty 
incremented when a proper axit is Found. The differance between 
these two is the number of keypoints that were discarded plus the 
number of keyooints that were outstanding at the end of the rune 
The kaypoints outstanding at the end of the run may be found near 
the end of TAPEL under the heading 'summary of stack index!. 


As each keypoint is entereds it is inserted into a linked list of 
procedure records. For each procedure records the linkage is 
such that the parent and all chitdren of the procedure may be 
deter mined, The procedure records are maintained such that If 
the orocsedure is called by more than 1 parent then a new 
procedure record is allocated. In this way statistics may be 
gathered for each procedure In its role as a child of different 
parents. A page fault keypoint has the pSage fault charged to 
its parent. The time statistics are accumulated ontiyv where 
kaeypoints have a valid exit. Howevers ali page fauits are 
recordeds so that a page fault will show up for a procedure call 
aven If it is subsequently discarded. 
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10.3 QPERATIONAL_PROCEDURES 
10.3.1 INSTALLATION 


To install thls program three flles are needadt: PMFPL», XULIS and 
PMFPLIS,. To compile and save the binaries of the call analysis 
program type? 


SES .PMFINST CALLAN COMBINE PRINT 


10.3.2 3643 PRICEDURE 


An SES procedure is provided in order to run the call anatysis 
program, Following is the description of aff the proc 
parameterse 


Any of the peremeatears defined in the SES module JOBPARM may be 
used. These include JO3TL»s JOBFLs JOBCN» JOBPRs JOBUN, JDAPWs 
JOSFMLYs JOBCNs JOBPNs LOCALs BATCHNs BATCH» DEFER» NODAYF>» 
DAYFILEs AND OF. (Sea SES Procedure Writer's Guides Appendix A) 


TPF Tape number or numbers containing preorocessed 
keypooints. If the VSN has leading zeros the VSN must be 
anclosed in string quotes ('), If the file is a 
muiti-reel tapes then the tist of tapes must be enclosed 
in parenthesise 
Examole TPF={('000123'»543210) Default nones 
one of TPF and OTF 
must be specifiec,. 


OTF Xisk File containing the oreprocessed keypotnts. 
Examole OTFeDTFL Default none 

one of TPF and OTF 

must be specifled. 


DSF File on which the keypoint descriptors reside. 
Exampie OSF=0SF1 Default none» 
required parametere 


REPORT Parmanent file name for the report file, 
example RcPORT=REPL Default REPORT. 


TAPEL Parmanent file name for the debugging file. 
=xampolte TAPE1=DEB1 Default TAPE1. 
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FIRST 


ID 


COMMENT 


PRINT 
NOEXIT 


RECIROS 


TOTAL 


NOWSORT 


STR 


Name of permanent flie where Intermediate sort data Is 
stored. 
Example FIRST=INTERM Default FIRST. 


If the the preprocessed keypoint data flie is In another 
user's arga this parameter must be soecified, 
Example [D=PM72 Default KEYPERF, 


A title for each page on the report may be specified 
using this perameter. The comment may de up to 50 
characters long. The string is enclosed In single 
quotes (!'), ; 


Dispose a copy of the report to the printer. 
No EXIT card inserted in the job stream. 


If you wish to process tess than the entire File soecify 
the number of resords you wish to process as 
RECORDS=nnannnn,. 


Process entire file without regard to task boundarless 


This keyword atlows you to obtain a report sorted in 
another order without running the analysis phase of the 
call analysis (the time consuming part). Use its coding 
the same parameters as you used for the original run. 


This parameter allows skioping the opreprocessed input 
file until @ given class and kaypoint is found. 
Example STR="1L2 4004'. 


This parameter allows termination of the call analysis 
run when a given class and keypoint are found on the 
ereprocessed keypolint file. 

Example STP='13 4004', 


The following are the allowable parameters for the SORTKEY liste 
They must be enclosed within parenthesis. 


SORTKEY 


This is the keyword for the vartous sort options. The 
SORTKEY options appear below, 


KEYPNT Report Is In increasing values of keypoints and 


elass (AI! keypoints for a given class come first). 
Example SORTKEY=(KEYPNT), 
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FUNCT Report is In Increasina values of the 2 tetter 
section name, (The 2 letters In the third column 
of the report) 


Report is in increasing vatues of the count of 
entries to the kaypoint 


YCOUNT Report is sorted in increasing value of matched 
exit count for the keysolnts 


CPTIME Report is sorted on Increasing valuas of CP time in 
the procedure. 


Avecp Report Is sorted on Increasing values of average CP 
time (CPTIME/ MATCHED COUNT) 


RLTIME Report Is sorted in increasing values of Real time 


AVRT Report is sorted in increasing order of average 


real time in the procedure 


CceT Report is sorted in ordar of increasing values of 
Child CP time 


PAGES Report is sorted In order of tincreasiIna number of 
page faults. 


C PAGES keport is sorted In order of Increasing number of 
Chitd page *aults. 


DESCR Report is sorted with descriptions in alohanumeric 
orders 


CHKYPT The children of each parent are sorted keypoint 
order. 
CHOP TM The children of each parent are sorted in order of 


increasing CP time. 


Any of the SORTKEY parameters may be sorted in decreasing order 
by prefixing the appropriate parameter with the IJletter 0. For 
instances, to sort such that the highest CP time is printed firsts 
use SORTKEY=DCPTIME. 


The order in which the SORTKEY oarameters apnear In the Itist 


datarnines whitch key is most significant. Qe 
SORTKEY= (DC PTIMESDORLTIMsKEYPNTsOCHOPT) atid sort first on CPTIME 
(highest first)» then on raal time(desceanding)» then oan 


keypointlascending) and finally on child CP timeat(descending). It 
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Is suggested that when serting In orders other than Keyonts, at 
feast one of the minor keys should be KEYPNTs In order to have 
ali the data concerning a kevpoint to appear in the same part of 
the reporte 


If you want to sort on any other Field that appears on the report 

all that is required is to define a field and a key in this proc, 
To find the column number where the field appears» attach the 
file determined by the FIRST parameter In a previous run. This 
file may be Inspected with an editors keeping In mind that the 
fine ftenath is about 300 ascii characters, Determine the column 
in which the desired sort parameter liess and modify the NOTE 
fines defining fields and keys for SORP accordingly. 


If you fnsoect this proc you will see that the file named by the 
FIRST osrameter is saved as a direct access file. The first 
programs, CALLAN uses the bulk of the processing times so 
different sort options may be obtained very cheaply by starting 
the program with the COMBINE program. This flie is used by the 
NEWSORT option to allow a report sorted In some other ordere Any 
number of reports may be genereted by running KPTRUN with the 
NEeWSORT parameter and using the proper copy of the FIRST file. 


102343 RUNNING CALL ANALYSIS 


The PROC ('*KPTRUN' uses the filie 'CALLAN'» produced by the 
TINSTALL! PROC. KPTRUN has 3 barameterse. The first parameter Is 
the name of the direct access file containing thea output from the 
keypoint preeprocessor. The default nane Is KPTOFL but anv PFN 
may be used by specifying parameter 1. This file is assumed to 
contain 2 logical recordse The first record is the kaypoint 
descriptors. The second record is the keypoint data file. 


The second parameter is the number of keypoints to be processed. 
The default Is 50000. If "CALLAN! Is run without using this 
PROC» thera is an internal limit of 396006 records. CALLAN reads 
the value from a file named PARMFL. Currentiys RECORDS =! is 
the onty parameter recognized on PARMFL. Please note the !=!? 
sign must be surrounded by spaces. The main consideration in 
selecting the number of records to process is the running time, 
While at this point we have timings only from one runs these show 
that ta orocess the first 10000 records takes a littie less than 
25 secondss the tast 10000 records on a 225900 record file take 
almost 433 seconds. This file had a number of Irregularities 
which may be the cause of this large Increase In running times 
but still the running time fs axpacted to iInerease as the 
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complexity of the call paths Increases, The memory requirements 
also increase dramatically as the number of records increases. 
To run the 225000 record file which was used for debuggings 274K 
octal was required. Much of this was probably due to the 
irregularities in the file. Stills runs of 109900 records or so 
are orobebly the most cost-effective, 


The third parameter is the name of the permanent file where the 
supplementary information concerning the run is stored. Mest of 
this information is for debuggings but It Is also useful to learn 
about the general structure of the file. This File may get to be 
over 1000 eprus and is generally Inspected at the terminals as 
there are many fines of output (17090 or more on a large keypoint 
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11.0 KEYPOINT QUERY FILE ANALYZER (KPQRY) 


11e0 KEYPQINT QUERY _EILE_ANALYZER_(KPORY) 


The keypoint query file analyzer (KPQRY) is a tool designed to 
assist in investigating the contents of large keypolnt files. 
This Is useful for dehugging and for determining the. 
characteristics of keypoint collection data. It has proved to be 
usaful in discovering unexpected and unusual sequences of 
keypoints and =In tractna abnormalities in the data file. It is 
designed to handle any type of keypoint File but is currently 
restricted to hardware coliected Kaypoints and to the output from 
the Kayoolnt pre—processore 


This program is not a somolete or formal implementation of an 


investigative facility but rather was developed as a debugging 
tool. 
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11.0 KEYPOINT QUERY FILE ANALYZER (KPQRY) 


11e1 KPQIRY_GENERAL_DESCRIPTION 


The KPQORY voregram reads the keypoint File end extracts pertinent 
information according to the Input-query parameters givene Thea 
first line of Input specifles the type of File being analyzed. 
Addition oarameter lines are given in the form of a small auery 
language. No attempt has been made to make this tanguage 
Stl! Lor 


The Implementation of tha program has been done In such a way as 
to make thea addition of other types of gqeuries easy without 
disturbing the main logic of the program and without extensive 
changes to other areas of the program All that Is required is 
to add the new mnemonic to a CASE statement and than to add the 
condition processor tn the body of the statement. 


KPQRY reads and analyzes all query directives and then evaluates 
these directives for each keypoint antry. The auery mnemonic 
datermines which field(s) of the keypoint entry are to be 
process@d. The grammar specification is right-recursive allowing 
the <axplist> of the query to ba rapaated as many times as can 
fit into an input fine. 


Qne or more spaces must separate each token of the query line. 


Recursion Is not allowed for binary queries such as class and 
keyooint number. 
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1leG KEYPOINT QUERY FILE ANALYZER (KpaRY) 
Lielel QUERY LANGUAGE GRAMMAR DEFINITION 


Llelel QUERY LANGUAGE GKAMMAR DEFINITION 


€query> = <mne>d> |; <mne> <list> 
<list> = <list> <explist> } <unop> NAME } <ynop> NUM 
<exalist> = <hinop> <list> | null 
<unop> = — | nul 
<binop> = + } * 
<mne> = CLSS (class number) 
KPN (kayooint number) 
DATA (data content) 
CLKP (kaypolnt class end number) 
CLOT (keypolnt class and data content) 
ENEX (entry/exit matching) 
BYVE Cbuffer overflow) 
CNT (C€scount occurences) 
TINT (time interval between dumps) 
TIM (time interval) 
NAME = Job names commands atce 
NUM = classs keypoint numbers task ids atce 
- = not 


+ = or 


* = and 
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i1.¢ KEYPOINT ous RY FILE ANALYZER (KPaRY) 
11.1.2 QUERY EXAMPLES 


L1.1.2 QUERY EXAMPLES 


HARD 
CLSS -3 * -4 * 5 


Thais request will print all occurences of classes other than 3» 


4, and 5 from a hardware collection keypoint files 
PRE 
CLKP 2 * 1106 


This requast will print all examplas of tha keypoilnt with class = 
2 and keypoint id = 1196 From a pre-processed keypoint file. 


This request would output all occurences of buffer overflow fror 
a hardware collected file, 


PRE 
TIM 1234 * 5672 


This requast sould print all kaypoints In tha time interval from 
1234 to 54578 microseconds in a ore-processed keypoint file. 
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11.3 KEYPOINT QUERY FILE ANALYZER CKPORY) | 
LlieZ OUTPUT REPORTS 


11.2 QUIPUT REPORTS 


HARD 
TIM 1234 * 5000 
OVFL 


DATAC1S) DATA(19) 
0 
400 102 


0 
4 
G 
0 
oO 
0 
c 
0 
6 
0 


GOooooecooavooeactoce 


ee pe 
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29 PRO PO 69 68 GS 2 Ud PSF) PO PO BE OD bs TE PD fe 9) Bo te PO Od DD Gd PO ON Od FO NW 
Coo G 
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11, 3 OP RATION is " PROCEDURES 


11.3 Q2ERATIONAL_2ROCEQUBES 
Lle3e1 INSTALLATION 


To Install this orogram three files are neededt PMFPL» XULIB and 
PMFPLTIS, Jo compile and save the binary of the query program 
tyoas 


SES s*PMFINST KPOQRY 


11.3.2 404 TO RUN KPQRY 


The KPORY program may be run by the following control card call? 
XKPQRYs input» cutoutsbinfile. 


where: input - contains the query directives 
output - contains the outout report 
binflle =- contains the binary keypotint fille. 


An SES orocedure called KPORY is available to run the query 
processor elther locally or as a batch job. The parameters for 
this proc are given below. 


Any of the parameters defined In the SES module JC8PARM may be 
used. These inctude JOBTLs» JOBFL» JOBCNs JOBPR»s JGBUN» JOD3PW, 
JOBFMLYs JIBENs JOBPNs LOCAL» BATSCHNs BATCHs DEFER» NODAYF>, 
DAYFILEs AND DF. (See SES Procedure Writer’s Guides Apoendix A) 


DTF If the raw data or oreprocessed keypoints Is on mass 
storages DTF specifies the file name in which the data 
is stored. The file may be locals direct access» or 
avyen indirect access although the tast aliternative is 
usually impractical. 

Exampte DTF=DATAFL Default DATAFL. 
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li.» 0 KEYPOENT QUE RY FILE ANALYZER (KPQRY) 
11.3.3 SES PROCEDURE 


TPF 


IF 


LTB 


LIBUN 


Tape number or araumbers cantaining the raw date or 
preprocessed keypoints. If the VSN has leading zeros 
the VSN must be enclosed in string quotes ('),. If the 
file is amutltliereel tapes then the list of tapes must 
ba enclosed in parenthesis. 

Example TPF=('000123'»s543210) Default none. 


This specifies the Input parameter file where the KPAQRY 

directivas ere found. 

Examole ITF=PAR™ Default none» 
(interactive Input). 


This specifies tha file on which the outout will be 

written. 

=z=wampje OF=0UT Default nones 
(interactive output). 


Name of file where the object code for XKPQRY is found, 
JIrdinarily this parameter is obtained from the ttoollib! 
parameter in the user's PROFILE. This parameter would 
ordinarily be used for testing a naw version of the 
preprocessors or for use of a specially modified version 
of the oreprocessore 

Examole LI3=MYLIB8 Default XULI83. 


Isar number where file spacified by LIB (above) resides. 
Irdinarlly this parameter Is obtained from the 'toolact! 
oarameter in the user's PROFILE. 

Fxample LIBUN=UN12 Default KEYPERF, 


Some examoles of how to Invoke the KPPRE procedure follows 


SEs eKPQRY DTFRKPTS This will enabie the user to run 


the query with interactive 
input/output. Howevers only one 
query per run is permitted. 
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12.0 PME COUNTER (REG. 22) STATISTICS {KPCNT) 


12.0 PME _COUNTER_{86Ga_22)_SIATISIICS_{KPCNID 


The PMS counters report has ean ramoved from the data reduction 
program KPRED for modularity of processing and to alleviate the 
data reduction program from this burden. 
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1200 PME CUUNTER (REG. 22) STATISTICS (KPCNT) 
12.1 KPCNT GENE 


1201 KPUNT_GENERAL_ DESCRIPTION 


The orogram reads in the Reg. 22 from the data collected fiie and 
generate statistics according to machine type and selected 
counters. 
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12.0 OMe COUNTER (REG. 22) STATISTICS (KPCNT) 
12.2 STATISTICS OUTPUT 


12.2 STALLS TIC oureur 


P - PMF Counter Statistics 


Statistics according to tha PMF req. 22 sat—-yup are available, 
Unieass the counter options are explicitly changed in the data 
collections they inciude? 


elanosed time 

nunbar of instructions exacuted 

cache hit ratio 

CP Monitor Mode 

MIPS rate 

average tine In Monitor Modes 

number of instructions per return statement. 


e «© @® © » © # 


These statistics are derived exstusivaly by the content of PHF 
Register 22. 
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L200 PMF COUNTER (REG. 22) STATISTICS (KPCNT) 
L2Ze2Zel MUTPUT REPORT 


Ll2e2e1 JUTPUT REPORT 


32 SVL PMF RUNs K3099 


PERFORMANCE MONITORING FACILITY == STATUS» CONTROL AND COUNTERS 


PMF-OP-IN-PROCESS 0 STOP=DETECTED=-KP=CLASS 1 STOP<DETECTED=COUNTER-QVERFLOW O KP=TIMER-CARRQY=ONT 9 


PMFeKP=REQUEST 1 START=ON“KP=CLASS 1 STOP<ON-KP=CLASS 1 
START-KP=CLASS 15 STOP-KP=CLASS 15 
STOP=$ON-C DUN TER -OVERFLOW-DESIGNATOR 


PROCE SSOR-INSTRUCTION-ARGUMENT 004 PROCESSOR-INSTRUCTION-MASK 377 


SELECT-AQ-AND=30 © AG-INPUT=SELECTOR 1 RO-INPUT=SELECTOR 13 
SELECT-AL-AND=31 0 AL-INPUT@$SELECTOR 5 BLI-INPUT@SELECTOR 12 
SELECT-A2Z-AND-B82 0 A2Z~INPUT=SELECTOR 7 B2-INPUT“SELECTOR 3 
SELEC T-A3~-AND-33 1 AZ-INPUT=SELECTOR 1% B3~-INPUT=SELECTOR 20 


COUNTER=-A0 47115539 CM READLOPERND WITH CACHE HIT) BO 93766828 
COUNTER-Al 3285315 CM READCDPRND WITH CACHE MISS) 31 677668 
COUNTER-A2 1531 PAGE TABLE SEARCH WITHOUT FIND Bz 23075E 
COUNTER-A2 11123474 CY185 MONTTOR MODE 33 54212534 


INSTR. EXECUTED 93766928 


93.481% 


CACHE HIT RATIO 


CPU MONITOR MODE 


2005182 
MIPS RATE = 1.730 


NOSINSTRe RETURN 1382359 
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1203 OPERATIONAL PROCEDURES 
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12.3 OPERATIONAL PROCEDURES 
L2Ze3e1 INSTALLATION 


To install this erogram three Files are needed: PMFPL,»s XULI2 and 
PRPPLT®,. To compile and save tha binary of the omf counters 
program types 


SESsPMFINST KPCNT 


124342 404 TO RUN KPCNT 


To run the KPCNT orograms 
XKPCNTsoutputscntfi, 


waeret output - contains the statistics printout 
entfl - contains the last record of the data collection 
file, 


12.323 SES PROCEDURE 


A SES procedure called KPCNT is available to run this program, 
It will automatically extract the counter record from the data 
collection file. The procfile will anabile the user to run the 
program locally or submit a batch job. The folloning parameters 
are availiable. 


Any of the parameters defined in the SES module JQBPARM may be 
“usede These include JOBTLs JOSFL» JOBCNs JOBPR»s JOBUN, JOBPW, 
JOBEMLYs JTUBON» JOBPN»s LOCAL» BATCHNs BATCH, DEFER, NODAYF> 
DAYFILEs AND OF. (See SES Procedure Writer's Guides Appandin A) 


OTF If the raw keypoint data Is on mass storages DTF 
specifies the file name in which the data is stcrede 
The file may be locals direct accesss or avean indirect 
access although the tfast aiternative is usually 
imoractical. 
=xampte OTF =DATAFL Default DATAFL. 


Control Data Private 


12-6 


Performance Reporting Facility ERS 


St Ro (REG. 22) STATISTICS (KPCNT) 


TPF 


LIBUN 
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RAE EVERE 


Jape number or numbers containing preprocessed 
kevpoints. If the VSN has teading zeros the VSN mwust be 
enciosed in string quotes (tt). If the file is 2 
multi-reel tapes then the List of tapes must be eanctosad 
in parenthesis. 
txampale TPF=('000123'»s 35432190) Default none» 
one of TPF and OTF 
must be specifiec. 


This file will contain the counter statistics. 
Zeemote CNF=OQKPCNT Default OKXPCNT. 


This parameter allows specifying a titie of up to &¢ 
characters. 
Examojea TIT='PmMF RUN FOR FEMit Default OMF RUN. 


Name of file where the object code for XKPCNT Is found. 
Irdinarity this parameter Is obtained from the 'toollid! 
Daraneter in the user's PROFILE. This parameter would 
ordinarily be used for testing a new version of the 
preprocessors or for use of a specially modified version 
of the preprocessor. | 

=xamole LIS=MYLI8 Default XULI3. 


User number where file specified by LI8A Cabove) resides, 
Ordinarily this parameter is obtained from the 'toolact! 
Parameter In the user's PROFILE. 

cxanole LISUN=UN12 Default KEYPERF, 


Following are some examples of Aow to invoke KPCNT3 


SESeKPCNT OTF=DATAFL This call will get File DATAFL> 


generate the statistics and 
dispose tha output to the 
printer. 


ES @KPCNT TPF=aABCO01 This call will submit a job to 


request tape ABCOOls generate 
the statistics and dispose the 
output to the printer, 
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13.0 STATISTICS FACILITY 


To ba supplied. 
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1. CYBER 189 Mainframe Model-Independent General Design 
Soecifications Revision T 
DCS document number ARH1799 
October 155 1981 


le CYBER 180 System Interface Standards Revision H 
9038 document number $2196 
August 27s 195982 


Le NOS/VE Cycle 7 Helpful Hints 


NOS/7V= Integration and Evaluation 
September 23% 1982 
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Al.U APPENDIX 4 -— SVL USAGE 


Al.O ABPENQIX_A_--_SVL_USASE 


The master account for PRF utilities at Sunnyvale is KEYPERF. 
SES procedures described in this documentation may be run by 
typing SES »KEYPERF.utility name or by putting KEYPERF into the 
search path in your PROFILE. a fustieg stubs ercaer 
ACQUIRE. PROCFIL/UN=KEYPERF and then running these procs as 
dascribed. 


In order to run PMF data collection on SN1S1 and SN1IG2»s PMF must 
ba invoked from the console under OLS prior to running the Job to 
be monitored. The sequence to do this Is as follows: 


X.DIS. 

SUN(KEYDERF ) 

GET{PMF) 
PMF(TY=SCOLLECTs TP=vsn) 
DROP. 


Data collection Is actually initlated by the first class 15 
kayooint ansountered by the PMF hardware and stopped by the 
second ones If> for some reasons the collection does not stops 
it may be terminated by 

SEOs Isn.STOP . 
or as a tast resort hy 


DROP a |S 
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B1.0 APPENDIX B -— COLLECT ICN RUN 


B1.0 APPE! 


QIX_B_-=_COLLECLLON_RUN 


This example shows how to start and stop 4 kevpoint collection 


runt 
SESSPMF Ty=COLLECT 
actkshss»mm=(2935399915) a0 


amik 


axet ees 
F 
amik 


deakes 


from 176 sides to seat up PME 
Rage2Z2» 

from 180 sides to enable 
kaypoint collections 

fron 180 sides to issue 
kot. class > to start 
collections 

from 180 sides start benchmarks 


from 139 sides», when bdenchmark 
terminateds to stop collectians 
from 186 sides to deactivate the 
keypoint collections 
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